API · invitations

List invitations

GET /api/v2/invitations

Authorization

Authenticated user session (use inboxit login). Use the CLI login flow; a workspace API key cannot call this operation.

Parameters

All resource access is checked against the selected workspace and user permissions.

Request

Run inboxit login first. The CLI supplies authenticated user credentials.

Example

inboxit invitations list

Response

HTTP 200. Example values are illustrative; excerpts are marked.

Example

{
  "invitations": [
    {
      "id": "INVITATION_UUID",
      "role": "operator",
      "expires_at": "2026-10-30T12:00:00Z",
      "workspace_name": "prod",
      "inviter_email": "owner@example.com"
    }
  ]
}

Behavior & errors

Discovers invitations matching the authenticated email after signup/sign-in; no automatic acceptance. Common errors: 400 invalid input, 401 unauthenticated, 403 insufficient permission, 404 missing/inaccessible resource, 409 conflict, 429 rate/usage limit, 503 service unavailable. See Errors & retries for recovery guidance.