Skip to main content

GET /v1/auth/invitations/preview?token=...

Look up an invitation by token. Used by the accept page to show "you've been invited to join Acme as a member" before the user clicks confirm.

::: tip Auth Required: none. The token IS the credential. :::

Request​

GET /v1/auth/invitations/preview?token=abc123...

Response​

200 OK​

{
"organization_name": "Acme Co.",
"role": "member",
"inviter_email": "[email protected]",
"email": "[email protected]",
"expires_at": "2026-06-04T12:00:00+00:00"
}

Error responses​

StatusCodeWhen
404not_foundToken doesn't match any invitation.
409conflictInvitation has been accepted, revoked, or expired.

Notes​

  • The payload is deliberately minimal — anyone with the link can hit this endpoint, so we expose only what's necessary to render the accept UI.
  • This endpoint MUST be mounted outside the auth middleware. See router_public() in the SDK.