list_invitations

List invitations

List workspace invitations.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:read
Workspace requirement: Authorized workspace and current membership required

Workspace administrator.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 100,
      "description": "Limit.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Offset.",
      "minimum": 0,
      "type": "integer"
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "has_more": {
      "description": "Has more.",
      "type": "boolean"
    },
    "invitations": {
      "description": "Invitations.",
      "items": {
        "additionalProperties": false,
        "description": "Invitations item.",
        "properties": {
          "accepted": {
            "description": "Accepted.",
            "type": "boolean"
          },
          "can_approve": {
            "description": "Can approve.",
            "type": "boolean"
          },
          "can_create_drafts": {
            "description": "Can create drafts.",
            "type": "boolean"
          },
          "can_publish": {
            "description": "Can publish.",
            "type": "boolean"
          },
          "email": {
            "description": "Email.",
            "format": "email",
            "type": "string"
          },
          "id": {
            "description": "Id.",
            "format": "uuid",
            "type": "string"
          },
          "requires_linkedin": {
            "description": "Requires linkedin.",
            "type": "boolean"
          },
          "role": {
            "description": "Role.",
            "enum": [
              "admin",
              "member"
            ]
          }
        },
        "required": [
          "id",
          "email",
          "role",
          "requires_linkedin",
          "can_create_drafts",
          "can_publish",
          "can_approve",
          "accepted"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "invitations",
    "has_more"
  ],
  "type": "object"
}

Example arguments

{
  "limit": 100,
  "offset": 0,
  "team_id": 42
}

Example result

{
  "has_more": false,
  "invitations": [
    {
      "accepted": false,
      "can_approve": false,
      "can_create_drafts": true,
      "can_publish": false,
      "email": "[email protected]",
      "id": "018f3c96-0d74-7b2b-9e10-5ecbbcd82921",
      "requires_linkedin": true,
      "role": "member"
    }
  ]
}

Errors and retry

Workspace reads require current membership; workspace and invitation administration requires an administrator, while creation requires account-level mcp:teams. Invalid/duplicate slugs or pending emails are rejected; unknown or cross-workspace invitations return not found, and accepted invitations cannot be changed or cancelled. Calls are limited to 120 per user per minute.

Reads are safe to retry. Before retrying workspace or invitation creation after an ambiguous response, list current workspaces or invitations. Updates may be retried after reading current state; never blindly repeat workspace deletion or invitation cancellation.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

teams.views.api_views.InvitationViewSet