tenants

Change Member Role

Change a member's tenant role (admin-only).

Blocks demoting the tenant's last admin to member (409), and blocks self-demotion (403): the caller's JWT still carries the old role until it refreshes, so demoting yourself is pointless and only causes confusion.

patch/tenants/members/role

Request

  • Base URL: https://api.incredibuild.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.incredibuild.com/tenants/members/role
  • Auth: HTTP bearer

Headers

x-public-tenant-idstring uuid nullable
x-public-user-idstring uuid nullable

Request body

emailstring email required
role'admin' | 'member' required

Tenant permission tier (IBS-1136). The public API uses the lowercase values; while the Descope mirror writes continue they map to its role names ("Admin"/"Viewer", member being Viewer).

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.