---
title: "Accept an invitation (requires authentication, email must match)"
method: POST
path: "/api/v1/user-invitations/accept"
tags: ["User Invitations"]
---

# Accept an invitation (requires authentication, email must match)

`POST /api/v1/user-invitations/accept`

Accept an invitation (requires authentication, email must match)

## Request body

- InvitationAcceptBody — Request body for accepting an invitation
  - `token` string, required — Raw invitation token from the email link

## Response `200`

Success

- InvitationAcceptResponse — Response from accepting an invitation
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required — Result of accepting an invitation
    - `status` union, required — Result of the accept operation: "accepted" for new role, "already_granted" if user already has the role
      - 'accepted'
      - 'already_granted'

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `410` — Response

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)