---
title: "Accept Invitation"
method: POST
path: "/v1/invitations/accept"
tags: ["v1", "protected", "workspace-invitations"]
---

# Accept Invitation

`POST /v1/invitations/accept`

Accept an invitation as the authenticated user.

An invitation sent to an email address is only accepted by the account
signed in under that address. Idempotent for the same acceptor.

The invitation is committed as accepted before membership is granted, and
it grants membership only until that grant is recorded: a graph outage on
the first call is retried, a replay of a used link grants nothing, and a
removal racing the accept wins.

## Request body

- AcceptInvitationBody
  - `token` string, required

## Response `200`

Successful Response

- AcceptInvitationResponse
  - `invitation_id` string, uuid, required
  - `user_id` string, required
  - `workspace_id` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-29** `e1a530c0a2d5` — 1 info
  - endpoint added
- **2026-03-30** `e9c153221160` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/invitations/accept/post.md)

---

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