Manual
CLI
API
Log in Get started free

Change a member's role

Makes a member an admin or a plain member.

Makes a member an admin or a plain member.

HTTP
PATCH /org/members/{userId}

Access: Session token only. API keys get 403 with insufficient_scope.

Role: Organisation owner or admin.

Path parameters #

ParameterDescription
userIdThe id of the member.

Request body #

JSON.

FieldTypeRequiredDescription
rolestringyesadmin or member.
JSON
{ "role": "admin" }

Response 200 #

The members of the organisation, as in List members.

Errors #

StatuserrorWhen
401unauthenticatedThe token is missing or not valid.
403forbiddenYou are not an owner or admin.
404not_foundThe user is not a member.
409owner_cannot_changeThe member is the owner. Use Transfer ownership.
422invalid_requestrole is not admin or member.
429rate_limitedToo many requests, see Rate limiting.

See Errors for the error format.