Skip to main content
Update a member

Authorizations

Authorization
string
header
required

Personal API key sent as a bearer token, together with X-Organization-Id. The key must have at least the access level the endpoint requires (read, write or admin).

Headers

X-Organization-Id
string

The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations.

Path Parameters

user_id
string
required
Required string length: 1 - 255

Body

application/json
role
enum<string>
Available options:
admin,
member
team_ids
string<uuid>[]

Every team the member is in; replaces their teams.

Maximum array length: 100
access_limit
object | null

The member's own access limit; null removes it.

allow_no_access
boolean

Save even when the change leaves a non-Admin member nothing to see. Without it, such a change returns 409 no_access_left naming them.

Response

The updated member. The last admin cannot be demoted.

user_id
string
required
Required string length: 1 - 255
organization_id
string
required
Required string length: 1 - 255
first_name
string | null
required
last_name
string | null
required
email
string | null
required
role
enum<string>
required
Available options:
admin,
member,
unsupported
teams
object[]
required

The teams the member is in, by name.

joined_at
string<date-time>
required
access_limit
object | null

The member's own access limit; null when they have none. Their teams' limits apply too; Admins are never limited. Omitted when the caller's own access is limited.