SteveSteve

Validate an invitation token

Returns whether the invitation is valid and, if so, basic user metadata for the onboarding screen.

GET /api/invitation/validate — internal browser-facing endpoint, not part of the external API.

Parameters

NameInRequiredDescription
tokenqueryyesInvitation token from the emailed link.

Response (200)

Success:

{
  "valid": true,
  "email": "admin@example.com",
  "name": "Jane Admin",
  "userType": "admin"
}

Failure:

{
  "valid": false,
  "error": "expired"
}

Error values: missing_token, not_found, expired, consumed.

Source

  • Handler: convex/http.ts
  • Logic: convex/invitations.tsvalidateInvitationToken

On this page