Update Organization Member Role
Updates an organization member’s role. Accepts either the coarse role (admin/viewer) or a role_id — a system role or one of your organization’s custom roles (see GET /api/v1/roles); provide exactly one. Requires a global API key. Cannot modify the API key’s owning user or the organization owner. Cannot demote the last remaining admin.
Path Parameters
The unique identifier of the target user
Body
Request body for updating an organization member's role. Provide exactly one of role or role_id.
Coarse role to assign. Mutually exclusive with role_id.
admin, viewer "admin"
Assign any role by ID — a system role or one of your organization's custom roles (see GET /api/v1/roles). Mutually exclusive with role. Returns 404 if the role does not exist or belongs to another organization. System role IDs are GUID-shaped sentinels (e.g. 00000000-0000-0000-0000-000000000001), not RFC 4122 UUIDs.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"789e0123-e89b-12d3-a456-426614174000"