POST/api/auth/verify-email/confirmPublic

Confirm an e-mail address with an e-mailed token

Consumes an e-mail verification token and marks the account's address as verified. Rate limited per IP.

operationId post_api_auth_verify_email_confirmAuthentication

Authentication & permissionsPublic

Anyone — no credentials required

Accepted credentials
None required
Notes
The single-use verification token is the credential.

Request body

Required — The body is parsed by the handler itself so its error format stays stable.

application/json
EmailVerificationConfirmRequestUnknown keys are rejected.
PropertyTypeDescription
token*string (uuid)

The verification token from the e-mailed link (?token=)

JSONExample
"token""123e4567-e89b-12d3-a456-426614174000"

Responses

application/json
SuccessMessageResponse
PropertyTypeDescription
success*true
message*string
JSONExample
"success"true
"message""string"

Example request

bashcurl
curl -X POST 'https://auth.schemavaults.com/api/auth/verify-email/confirm' \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "123e4567-e89b-12d3-a456-426614174000"
}'