Skip to content

Validate Invite Token Post

POST
/auth/invites/validate
curl --request POST \
--url https://example.com/auth/invites/validate \
--header 'Content-Type: application/json' \
--data '{ "token": "example" }'

Check whether an invite token is still usable, without consuming it.

Public, no auth required — lets AcceptInvitePage show an error state immediately for a revoked/expired/already-redeemed link instead of a form that would only fail at submit. The token travels in the body, not the URL.

Media typeapplication/json
TokenValidityRequest

Body of the POST token-validity checks: the token stays out of the URL and so out of access logs, browser history and Referer headers.

object
token
required
Token
string
<= 512 characters

Example generated

{
"token": "example"
}

Successful Response

Media typeapplication/json
TokenValidityResponse

Response for a public, side-effect-free “is this token still usable” check — lets a link-landing page (reset-password, accept-invite) show an error state immediately instead of rendering a form that is doomed to fail at submit. Never reveals why a token is invalid (unknown vs expired vs already used vs revoked) — that distinction isn’t needed by the caller and would leak more than the caller asked for.

object
valid
required
Valid
boolean

Example generated

{
"valid": true
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object

Example generated

{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}