/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Reset Password

Reset Password

Set a new password with the token from a reset email.

POST/v1/auth/reset-passwordTry it

Sets a new password with the token from a Forgot Password email, then signs out every session of the account — browsers and stx CLI logins alike. Sign in again with Log In.

Note

Public — the token is the credential. Each token works once and expires an hour after it was sent. To change the password while signed in, use Change Password.

Request Body

NameDescription
token:stringbodyRequired
The token from the reset link, at least 16 characters.
password:stringbodyRequired
The new password, 8–128 characters.

Errors

StatusCodeWhen
400validation_errortoken is missing or too short, or password is under 8 or over 128 characters
400bad_requestThe token is unknown, already used or expired (Invalid or expired reset link) — ask for a new email
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X POST https://api.syntext.dev/v1/auth/reset-password \
-H "Content-Type: application/json" \
-d '{ "token": "'"$RESET_TOKEN"'", "password": "a-new-long-password" }'
Responseapplication/json
200OK
{
"data": { "reset": true }
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext