Sign in

Confirm Password Reset

POST https://{organization}.myguper.com/api/connect/password-reset/confirm

Confirms a password-reset request by consuming the token and setting a new password.

The caller authenticates via RSA signature (OriginValidation middleware), the same mechanism used in the request step. The verified user-agent must match the origin that created the reset request — this is the origin lock. A token issued by admin cannot be confirmed by storemanager, even with a valid signature.

Token rules:

  • Single-use — once confirmed, the token is marked used and cannot be redeemed again.
  • Expires after 1 hour from creation.
  • Any pending tokens for the same (organization, login) are superseded when a new request is created.

Password history: The new password is checked against the user's current password and their last 10 password hashes. If the password has been used before, the request is rejected with HTTP 400.

On success, the user's password is updated, brute-force login attempt records are cleared, and the token is marked as used.

Try-it values populated from environment ACME (Demo)


Authentication

Signature

RSA signature via OriginValidation middleware. The user-agent must match the origin that created the reset request (origin lock).

Headers

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Request body

Content-Type: application/json

{
    "token": "a1b2c3d4e5f6...64 hex characters",
    "password": "NewSecurePass123!"
}

Responses

{
    "success": true
}

Related

Copied to clipboard