---
title: "Accept Invitation Endpoint"
method: POST
path: "/api/v0/invitations/accept"
tags: ["organizations"]
---

# Accept Invitation Endpoint

`POST /api/v0/invitations/accept`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/invitations/accept`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/invitations/accept/post.ts> (a function with typed inputs; its response is checked against the schema)

Consume an invitation token.

Requires JWT auth (Auth0); API-key callers are rejected. In ``use_auth=False`` dev/on-prem
builds the dependency falls through to the seeded dev user; the
email check then runs against ``users.email`` as set by your seed.

## Request body

- AcceptInvitationRequest
  - `token` string, required

## Response `200`

Successful Response

- AcceptInvitationResponse
  - `organization` OrganizationResponse, required
    - `public_id` string, uuid, required: The public id of the organization.
    - `name` string, required: The name of the organization.
    - `role` string, required: The caller's role in this organization: `admin` or `member`.
    - `created_at` string, date-time, required: When the organization was created.
    - `updated_at` string, date-time, required: When the organization was last updated.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-13** `7f81908bcdfe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/invitations/accept/post.md)

---

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