invite_project_collaborator

Invite a user to a project by email. Requires Owner role on the project. If the email belongs to an active workspace member, access is granted immediately and they receive a project-access email. Otherwise a pending project grant and workspace invitation are created together — the invitee receives a workspace invite email and both grants are resolved when they sign up. Calling this twice for the same pending-invite email is idempotent: the existing grants are returned and workspace_invite will be ‘reused’. role: one of ‘viewer’, ‘editor’, ‘owner’ (default: viewer). Returns: grant_id, project, email, role, pending (bool), workspace_invite (‘created’ | ‘reused’ | ‘already_active’). Requires Pro plan.

Parameters

Name	Type	Required	Default	Description
project_name	str	Yes	—
email	str	Yes	—
role	str	No	'viewer'

Returns

Returns a structured object. Top-level fields:

• grant_id (string)
• project (string)
• email (string)
• role (string)
• pending (boolean)
• workspace_invite (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "invite_project_collaborator",
  "arguments": {
    "project_name": "forecasts",
    "email": "carol@example.com",
    "role": "editor"
  }
}

Response

{
  "grant_id": "99999999-9999-9999-9999-999999999999",
  "project": "forecasts",
  "email": "carol@example.com",
  "role": "editor",
  "pending": true,
  "workspace_invite": "created"
}

Notes

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