Assign Member Role

Required role: admin or higher.

Assign or change a user's role in the acting tenant. The role is capped at the caller's own role and may not be owner.

Path Parameters
user_id uuid — REQUIRED User identifier

Request Body — REQUIRED
role string — REQUIRED Possible values: [read, write, admin] A role assignable to a tenant member: read, write, or admin. owner is a platform-wide role, not a tenant membership, so it is not a valid value here.

Responses
200 Role assigned
403 Caller's role is below the required role, or the requested role is owner Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.
404 No user with that identifier Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.
500 Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.