PATCH/api/organizations/{organization_id}/members/{uid}/roleAuthenticated

Change a member's role

Promotes a member to owner or demotes an owner to member. Only organization owners and platform administrators may change roles; the last owner cannot be demoted, the virtual admin role cannot be assigned, and roles in system organizations cannot be changed.

operationId patch_api_organizations_organization_id_members_uid_roleOrganizations

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials
Who may call
Any authenticated user
Notes
The caller must be an owner of the organization or a platform administrator.

Path parameters

NameTypeDescription
organization_id*string

Organization id (URL-safe slug)

uid*string (uuid)

User id of the member

Request body

Required

application/json
UpdateOrganizationMemberRoleRequest
PropertyTypeDescription
role*string

Membership role in the organization: owner, member, or admin (the virtual role platform administrators hold in the owner organization).

JSONExample
"role""member"

Responses

application/json
SuccessMessageResponse
PropertyTypeDescription
success*true
message*string
JSONExample
"success"true
"message""string"

Example request

bashcurl
curl -X PATCH 'https://auth.schemavaults.com/api/organizations/<organization_id>/members/<uid>/role' \
  -b 'refresh_token_<auth_server_app_id>=<value>' \
  -H 'Content-Type: application/json' \
  -d '{
  "role": "member"
}'

Other methods on this path

PATCH /api/organizations/{organization_id}/members/{uid}/role | SchemaVaults Auth API