Change a team member's role
PUT/members/:member_id
Changes the organization role of an existing member.
Requires the admin role. Only an owner may grant or revoke owner.
An organization's last owner cannot be demoted
(last_owner_protected), and a member cannot change their own role
(self_role_change).
Refuses API keys. This endpoint is reachable only by a signed-in
person; an API key receives 403 with the code
unauthorized_principal_kind.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 503
The updated membership
role is not one of owner, admin, member
Not authenticated
An API key was presented (unauthorized_principal_kind), the
caller is not an admin, the change would remove the last owner
(last_owner_protected), or the caller targeted themselves
(self_role_change).
No such membership in this organization
The platform identity service is unavailable or the organization is not provisioned