---
title: "Accept Invitation"
method: POST
path: "/api/v1/invitations/accept"
tags: ["Invitations"]
---

# Accept Invitation

`POST /api/v1/invitations/accept`

## Request

- Base URL: `https://app.perlucem.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.perlucem.ai/api/v1/invitations/accept`
- Auth: none declared

Accept an invitation after Cognito signup.

Process:
1. Validate invitation token
2. Create user_bank_assignment
3. Mark invitation as accepted

Note: User account is created via Cognito in the frontend.
This endpoint is called after successful Cognito signup.

Args:
    request: Invitation acceptance data with Cognito user_id

Returns:
    Success status and bank info

## Request body

- InvitationAcceptRequest: Request to accept an invitation after Cognito signup
  - `invitation_token` string, required
  - `user_id` string, required

## Response `200`

Successful Response

- InvitationAcceptResponse: Response after accepting invitation
  - `success` boolean, required
  - `message` string, required
  - `bank_name` string, nullable
  - `rssd_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/perlucem/apis/perlucem-ai-backend.md) · [All operations](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/revisions/96c4a286c624?raw)