change_user_role

Update a tenant member’s role. Requires Owner role. role must be one of: owner, editor, viewer. Cannot demote the last owner of a tenant. Returns: target_user_id (str) — UUID of the updated member; new_role (str) — the role that was assigned.

Parameters

Name	Type	Required	Default	Description
target_user_id	str	Yes	—
role	str	Yes	—

Returns

Returns a structured object. Top-level fields:

• target_user_id (string)
• new_role (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "change_user_role",
  "arguments": {
    "target_user_id": "33333333-3333-3333-3333-333333333333",
    "role": "editor"
  }
}

Response

{
  "target_user_id": "33333333-3333-3333-3333-333333333333",
  "new_role": "editor"
}

Notes

• Module: Admin
• Requires authentication via API token or Auth0 JWT.