Skip to content

Preview Invitation

POST /invitations/preview

Unauthenticated by necessity — the recipient has no account yet.

Request body — `InvitationTokenRequest`

Field	Type		Notes
`token`	string	required	min length 16 max length 200

Responses

Status	Description	Body
`200`	Successful Response	`InvitationPreview`
`422`	Validation Error	`HTTPValidationError`

Example

The body shows the fields the schema always carries. Which combination is legal is a service rule the schema cannot express, so read the description above before copying this.

curl -X POST https://your-deployment.example.com/invitations/preview \
  -H "Content-Type: application/json" \
  -d '{
       "token": "string"
     }'

Response — `InvitationPreview`

Field	Type		Notes
`organization_name`	string	required	—
`workspace_name`	string \| null	optional	—
`role`	`viewer` \| `member` \| `admin` \| `owner` \| `operator`	required	—
`email`	string \| null	optional	—
`expires_at`	string (date-time)	required	—