Skip to main content
PATCH
/
organizations
/
{organization_id}
/
users
/
{user_id}
Update Organization User Role
curl --request PATCH \
  --url https://api.example.com/organizations/{organization_id}/users/{user_id}

​
PATCH /organizations//users/

Reassign the organization-level role for an existing member. Use this to promote or demote users within the organization’s role hierarchy.

​
Notes

  • Requires owner role. Only organization owners can change user roles. Returns 403 for all other roles.
  • Valid roles are: owner, admin, member, viewer.
  • Returns 422 if the supplied role is not one of the valid options.
  • Returns 404 if the target user is not a member of the organization.
  • Promoting a user to owner automatically grants them admin-level workspace access across all workspaces in the organization.
Promoting a user to owner is a powerful action — it cascades workspace-level admin permissions. Only do this intentionally.