Cancel invitation

Authorization and permissions

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

OAuth scope

mcp:invitations

Workspace requirement

Authorized workspace and current membership required

Workspace administrator; accepted invitations immutable.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "invitation_id": {
      "description": "Invitation id.",
      "format": "uuid",
      "type": "string"
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "invitation_id"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "deleted": {
      "const": true,
      "description": "Deleted."
    },
    "invitation_id": {
      "description": "Invitation id.",
      "type": "string"
    }
  },
  "required": [
    "deleted",
    "invitation_id"
  ],
  "type": "object"
}

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.

InvitationViewSet.perform_destroy