Skip to content
Kapten
Esc
↑↓navigate↵open⌘Jpreview

Accept an invitation

Makes the caller a member with the invitation’s Role. The caller’s verified email must be the invited address (403 otherwise); an unknown, expired, canceled or already accepted invitation answers 410.

POST/invitations/accept
Authorization
AuthorizationBearer token (JWT) · headerrequired

An access token issued by this service (RFC 9068), in the Authorization header as Bearer <token>.

Request body
requiredapplication/json
tokenstringrequired

The secret from the invitation link, {ui_url}/invitations/{token}.

Responses
200

The organization joined.

idstring<uuid>required
namestringrequired
slugstringrequired

URL-safe handle, unique across organizations.

created_atstring<date-time>required
updated_atstring<date-time>required
default

The request failed.

errorstringrequired

Stable machine-readable code.

Allowed:invalid_requestunauthorizedforbiddennot_foundconflictgoneunavailableinternal
messagestringrequired

Human-readable explanation.

Request
curl -X POST 'https://auth.kapten.io/invitations/accept' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "string"
}'
Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "slug": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

Was this page helpful?