change_collaborator_role

Change the project role for an active collaborator. Requires Owner role on the project. target_user_id: UUID of the collaborator to update. role: one of ‘viewer’, ‘editor’, ‘owner’. Cannot demote the only project owner. Returns: grant_id, project, user_id, new_role.

Parameters

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

Returns

Returns a structured object. Top-level fields:

• grant_id (string)
• project (string)
• user_id (string)
• new_role (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "change_collaborator_role",
  "arguments": {
    "project_name": "forecasts",
    "target_user_id": "33333333-3333-3333-3333-333333333333",
    "role": "owner"
  }
}

Response

{
  "grant_id": "99999999-9999-9999-9999-999999999999",
  "project": "forecasts",
  "user_id": "33333333-3333-3333-3333-333333333333",
  "new_role": "owner"
}

Notes

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