Skip to main content
PATCH
Update Organization User Role

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.