---
title: "Accept an invitation addressed to your account email or username."
method: POST
path: "/v1/access/invites/accept"
tags: ["account"]
---

# Accept an invitation addressed to your account email or username.

`POST /v1/access/invites/accept`

## Request

- Base URL: `https://api.kody.codes`
- URL: `https://api.kody.codes/v1/access/invites/accept`
- Auth: HTTP bearer

Accept an invitation addressed to your account email or username. Pass the token from inviteCreate. Membership invites add you to that organization. Grant invites write the grant. The prompt from inviteCreate includes the organization slug and this call.

Org permission: `org:read`.

## Request body

- object
  - `token` string, required

## Response `200`

Success.

- object
  - `invite_id` string, required
  - `org_id` string, required
  - `org_slug` string, required
  - `kind` 'membership' | 'grant', required
  - `status` 'accepted', required

## Other responses

- `400`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `401`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `403`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `404`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `409`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `413`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `429`: Too many requests (edge IP/token limit) or an entitlement / plan-cap limit. Wait at least `Retry-After` seconds before retrying.
- `500`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `503`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `default`: Error envelope `{ "error": { "code", "message", "details"? } }`.

---

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