---
title: "Accept Team Invitation Route"
method: POST
path: "/v1/team/invitations/accept"
tags: ["Team"]
---

# Accept Team Invitation Route

`POST /v1/team/invitations/accept`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/team/invitations/accept`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Accept an invitation for the authenticated user and switch the session context.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- TeamInvitationAcceptRequest: Payload for accepting an invitation.
  - `token` string, required

## Response `200`

Successful Response

- TeamInvitationAcceptResponse: Auth/session payload returned after accepting an invitation.
  - `access_token` string, required
  - `token_type` string
  - `expires_in` integer, required
  - `user` AuthUserResponse, required: Authenticated user details.
    - `id` string, uuid, required
    - `email` string, email, required
    - `full_name` string, nullable
    - `timezone` string, required
    - `email_verified` boolean, required
    - `created_at` string, date-time, required
  - `organization` AuthOrganizationResponse, required: Organization details.
    - `id` string, uuid, required
    - `name` string, required
  - `organization_role` string, required
  - `permissions` AuthPermissionResponse, required: Resolved role-based permission flags for the current organization.
    - `can_manage_members` boolean, required
    - `can_manage_billing` boolean, required
    - `can_manage_api_keys` boolean, required
    - `can_manage_integrations` boolean, required
    - `can_publish` boolean, required
    - `can_delete_assets` boolean, required
    - `can_reset_sandbox` boolean, required
    - `can_view_reports` boolean, required
    - `can_delete_content` boolean, required
  - `active_project` AuthWorkspaceResponse, required: Authenticated project/workspace details.
    - `id` string, uuid, required
    - `name` string, required
    - `environment` 'production' | 'sandbox', required: Environment mode for an isolated project/workspace.
    - `timezone` string, required
    - `plan` 'free' | 'starter' | 'growth' | 'pro' | 'enterprise', required: Subscription plan tiers.
  - `projects` AuthWorkspaceResponse[], required
    - `id` string, uuid, required
    - `name` string, required
    - `environment` 'production' | 'sandbox', required: Environment mode for an isolated project/workspace.
    - `timezone` string, required
    - `plan` 'free' | 'starter' | 'growth' | 'pro' | 'enterprise', required: Subscription plan tiers.
  - `available_organizations` AuthOrganizationSessionResponse[], required
    - `organization` AuthOrganizationResponse, required: Organization details.
      - `id` string, uuid, required
      - `name` string, required
    - `organization_role` string, required
    - `permissions` AuthPermissionResponse, required: Resolved role-based permission flags for the current organization.
      - `can_manage_members` boolean, required
      - `can_manage_billing` boolean, required
      - `can_manage_api_keys` boolean, required
      - `can_manage_integrations` boolean, required
      - `can_publish` boolean, required
      - `can_delete_assets` boolean, required
      - `can_reset_sandbox` boolean, required
      - `can_view_reports` boolean, required
      - `can_delete_content` boolean, required
    - `active_project` AuthWorkspaceResponse, required: Authenticated project/workspace details.
      - `id` string, uuid, required
      - `name` string, required
      - `environment` 'production' | 'sandbox', required: Environment mode for an isolated project/workspace.
      - `timezone` string, required
      - `plan` 'free' | 'starter' | 'growth' | 'pro' | 'enterprise', required: Subscription plan tiers.
    - `projects` AuthWorkspaceResponse[], required
      - `id` string, uuid, required
      - `name` string, required
      - `environment` 'production' | 'sandbox', required: Environment mode for an isolated project/workspace.
      - `timezone` string, required
      - `plan` 'free' | 'starter' | 'growth' | 'pro' | 'enterprise', required: Subscription plan tiers.
  - `workspace` AuthWorkspaceResponse, required: Authenticated project/workspace details.
    - `id` string, uuid, required
    - `name` string, required
    - `environment` 'production' | 'sandbox', required: Environment mode for an isolated project/workspace.
    - `timezone` string, required
    - `plan` 'free' | 'starter' | 'growth' | 'pro' | 'enterprise', required: Subscription plan tiers.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pinbridge/apis/pinbridge-api.md) · [All operations](https://skmtc.dev/pinbridge/apis/pinbridge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinbridge/apis/pinbridge-api/revisions/b17603589d01?raw)