Skip to content

list_project_collaborators

List all active and pending collaborators for a project. Requires at least Viewer role on the project. Returns: project (str); collaborators (list[{grant_id, user_id, email, display_name, role, pending}]); count (int). Pending entries have user_id=null and pending=true — the invitee has not yet joined the workspace.

read-only · idempotent

NameTypeRequiredDefaultDescription
project_namestrYes

Returns a structured object. Top-level fields:

  • project (string)
  • collaborators (array<object>)
  • count (integer)

See the response example below for the full payload shape.

{
"name": "list_project_collaborators",
"arguments": {
"project_name": "forecasts"
}
}
{
"project": "forecasts",
"collaborators": [
{
"grant_id": "99999999-9999-9999-9999-999999999999",
"user_id": "22222222-2222-2222-2222-222222222222",
"email": "alice@example.com",
"display_name": "Alice",
"role": "owner",
"pending": false
},
{
"grant_id": "55555555-5555-5555-5555-555555555555",
"user_id": "33333333-3333-3333-3333-333333333333",
"email": "bob@example.com",
"display_name": "Bob",
"role": "editor",
"pending": false
}
],
"count": 2
}
  • Module: Collaborators
  • Requires authentication via API token or Auth0 JWT.