ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiAuth

Reset password

POST
/api/v1/auth/reset-password

Reset password using token from email. Rate limited to 5 requests per hour.

Header Parameters

X-API-Version?string

API version for header-based versioning

Default"1"
Value in"1""2"

Request Body

application/json
  1. body
token*string

Password reset token received via email

newPassword*string

New password (min 8 chars, must include uppercase, lowercase, number, and special character)

Length8 <= length <= 100

Response Body

Password reset successful

response?unknownapplication/json
Example Request
curl -X POST 'http://localhost:3001/api/v1/auth/reset-password' \  -H 'Content-Type: application/json' \  -d '{  "token": "abc123def456ghi789",  "newPassword": "NewSecurePass123!"}'
Example Response
{  "status": "success",  "statusCode": 200,  "message": "Password reset successful. Please login with your new password.",  "data": null,  "meta": {    "user_id": "123e4567-e89b-12d3-a456-426614174000",    "password_reset_at": "2026-01-31T10:00:00.000Z"  },  "timestamp": "2026-01-31T10:00:00.000Z",  "path": "/api/v1/auth/reset-password"}