Update a member's role

Changes a member’s account role. Owner-only: MEMBERS_MANAGE is granted to OWNER alone, so no lesser role can assign itself a permission it lacks.

Authentication

X-Workspace-Idstring
API Key authentication via header

Path parameters

user_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
roleenumRequired

A member’s role on an Account (the tenant above workspaces).

Grants access to ALL of the account’s workspaces; the role varies the permission level, not which workspaces (see agency design §4). Phase 0 assigns only OWNER; the rest exist for the later agency phase.

Response

Successful Response
user_idstringformat: "uuid"
emailstring
namestring or null
roleenum

A member’s role on an Account (the tenant above workspaces).

Grants access to ALL of the account’s workspaces; the role varies the permission level, not which workspaces (see agency design §4). Phase 0 assigns only OWNER; the rest exist for the later agency phase.

created_atdatetime

Errors

422
Unprocessable Entity Error