/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Change Unverified Email

Change Unverified Email

Fix the address on an account that hasn't verified it yet, and send a new verification link.

POST/v1/auth/change-emailTry it
Session token

Changes the email address on your account before it's verified — to fix a typo, or to replace a GitHub noreply address that can't receive mail — and sends a new verification link to the new address.

Note

Requires a session JWT — a dashboard session or an stx login token. API keys are rejected with 401. Any plan. Only for accounts whose email isn't verified yet.

Every verification link sent earlier stops working, so a link that went to the mistyped address can't verify the account. A verified address can't be changed here.

Request Body

NameDescription
email:stringbodyRequired
The new address, up to 320 characters. Surrounding spaces are trimmed. Any other key is a 400 validation_error.

Response — 200 OK

NameDescription
email:stringbody
The address now on the account.
verificationSent:booleanbody
Whether the new verification email went out. The address is changed either way; when this is false, resend the link from the dashboard.

Error Responses

400 Bad Request

email_unchanged — the address is already the one on the account (compared without case). Resend the verification link instead:

json
{
"error": {
"code": "email_unchanged",
"message": "That is already the address on this account. Resend the verification link instead.",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

validation_error — email is missing or isn't an email address.

401 Unauthorized

unauthorized for a missing, invalid or expired token (or an API key); session_revoked when the session has been signed out.

404 Not Found

not_found — the account has been deleted.

409 Conflict

email_already_verified — the account's address is already verified, so it can't be changed here:

json
{
"error": {
"code": "email_already_verified",
"message": "This account's email address is already verified and cannot be changed here.",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

email_in_use — another account already uses the address (compared without case):

json
{
"error": {
"code": "email_in_use",
"message": "Another account already uses this email address.",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}

429 Too Many Requests

rate_limited — over 5 requests to this endpoint from your account within an hour, counting ones that failed. Each change sends an email. The response has a Retry-After: 3600 header:

json
{
"error": {
"code": "rate_limited",
"message": "Too many email changes. Try again in an hour.",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X POST https://api.syntext.dev/v1/auth/change-email \
-H "Authorization: Bearer $SYNTEXT_JWT" \
-H "Content-Type: application/json" \
-d '{ "email": "alex@example.com" }'
Responseapplication/json
200OK
{
"data": {
"email": "alex@example.com",
"verificationSent": true
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext