Skip to content

Re-send the email-verification message

POST
/v1/auth/resend-verification
curl --request POST \
--url https://api.aetherpush.com/v1/auth/resend-verification \
--header 'Content-Type: application/json' \
--data '{ "email": "adrian@aetherpush.com" }'

Sends a new verification email to an account that has not yet verified its email. To prevent enumeration, the response is the same generic message regardless of whether the email matches an existing unverified account.

Rate limits:

  • 3 requests per IP per 60 minutes.
  • 1 verification email per account per 60 seconds.
  • 5 verification emails per account per 60 minutes.
Media typeapplication/json
object
email
required
string format: email
Example
{
"email": "adrian@aetherpush.com"
}

Generic confirmation message.

Media typeapplication/json
object
message
required
string
emailSent
required
boolean
Example
{
"message": "If an unverified account exists with this email, a verification link has been sent.",
"emailSent": true
}

Email missing.

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": "Email is required.",
"requestId": "req_abc123"
}

Too many requests, or per-account cooldown active.

Media typeapplication/json

Returned with HTTP 429 when an endpoint-specific rate limit is hit. retryAfterSeconds indicates how long the client should wait before retrying.

object
error
required
string
retryAfterSeconds
integer
>= 1
requestId
string
Examples

IP-level limit hit

{
"error": "Too many requests. Please try again later.",
"retryAfterSeconds": 3600,
"requestId": "req_abc123"
}

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"
}