Verify an email address without putting the token in the URL

POST

/v1/auth/verify-email

curl --request POST \
  --url https://api.aetherpush.com/v1/auth/verify-email \
  --header 'Content-Type: application/json' \
  --data '{ "token": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" }'

• Production
• Staging
• Local development

Consumes a one-time verification token from a JSON body and marks the account’s email as verified. The dashboard removes the token from its URL fragment before making this request, so neither request URL nor access logs contain the token.

Request Body^required

Media typeapplication/json

object

token

required

The one-time token from the verification email’s URL fragment.

string

/^[0-9a-fA-F]{64}$/

Responses

200

Email verified successfully.

Media typeapplication/json

object

message

required

string

Example

{
  "message": "Email verified successfully. You can now log in."
}

400

Token missing, malformed, invalid, expired, or already used.

Media typeapplication/json

object

error

required

string

code

required

string

Allowed values: verification_token_required verification_token_invalid verification_token_expired verification_token_used

requestId

required

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "This verification token has expired.",
  "code": "verification_token_required",
  "requestId": "req_abc123"
}

500

Internal server error.

Media typeapplication/json

object

error

required

Human-readable error message.

string

requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}