Re-send the email-verification message
const url = 'https://api.aetherpush.com/v1/auth/resend-verification';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"email":"adrian@aetherpush.com"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Example
{ "email": "adrian@aetherpush.com"}Responses
Section titled “Responses”Generic confirmation message.
object
Example
{ "message": "If an unverified account exists with this email, check that inbox for a verification link.", "emailSent": true}Email missing.
Standard error envelope. code is the stable machine identifier for
client branching and i18n. The wording of error is a human-readable
fallback and is not part of the contract. Specialized responses keep
narrower code enums where clients already branch on them.
object
Human-readable error message.
Stable machine code. Prefer this over matching on error. The
values this API can answer with are listed in the ApiErrorCode
schema of the raw document at
https://api.aetherpush.com/openapi.yaml. The field stays an
open string here so that a release adding a value does not
invalidate this response.
Unique identifier for the request, also exposed as the X-Request-Id response header.
Example
{ "error": "Email is required.", "code": "email_required", "requestId": "req_abc123"}Too many requests, or per-account cooldown active.
Returned with HTTP 429 when an endpoint-specific rate limit is hit,
including the per-tenant management API budget. Not the process-wide
address limiter (see GlobalAddressRateLimitErrorResponse).
retryAfterSeconds
indicates how long the client should wait before retrying, and matches
the Retry-After header when that header is set. code names the
limit that fired so clients can translate without matching on error.
object
Examples
IP-level limit hit
{ "error": "Too many requests. Please try again later.", "code": "too_many_requests", "retryAfterSeconds": 3600, "requestId": "req_abc123"}Per-account 60-second cooldown
{ "error": "Please wait at least 60 seconds before requesting another verification email.", "code": "verification_email_cooldown", "retryAfterSeconds": 60, "requestId": "req_abc123"}Per-account five-per-hour cap
{ "error": "Too many verification email requests. Please try again later.", "code": "too_many_verification_email_requests", "retryAfterSeconds": 3600, "requestId": "req_abc123"}Internal server error.
Standard error envelope. code is the stable machine identifier for
client branching and i18n. The wording of error is a human-readable
fallback and is not part of the contract. Specialized responses keep
narrower code enums where clients already branch on them.
object
Human-readable error message.
Stable machine code. Prefer this over matching on error. The
values this API can answer with are listed in the ApiErrorCode
schema of the raw document at
https://api.aetherpush.com/openapi.yaml. The field stays an
open string here so that a release adding a value does not
invalidate this response.
Unique identifier for the request, also exposed as the X-Request-Id response header.
Example
{ "error": "The requested resource was not found.", "code": "not_found", "requestId": "req_abc123"}