Change password

POST https://app.speybooks.com/api/v1/auth/password

Change the authenticated user's password. Requires the current password for verification. On success, increments token_generation which invalidates all existing refresh tokens, forcing re-login on other devices.

The new password must meet the password policy (minimum length, complexity requirements defined in password-rules).

Body parameters

currentPassword string required

Current account password for verification.

newPassword string required

min length: 8

Response

200 Password changed. All existing refresh tokens are invalidated.

Error codes

400 New password does not meet requirements.

401 Current password is incorrect.

Request POST /v1/auth/password curl

curl -X POST https://api.speybooks.com/v1/auth/password \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"currentPassword": "...", "newPassword": "..."}'

Response 200

{
  "success": true
}