ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiAuth

Request password reset

POST
/api/v1/auth/forgot-password

Sends password reset link to user email. Rate limited to 3 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
email*string

User email address for password reset

Response Body

Password reset email sent

response?unknownapplication/json
Example Request
curl -X POST 'http://localhost:3001/api/v1/auth/forgot-password' \  -H 'Content-Type: application/json' \  -d '{  "email": "john.doe@example.com"}'
Example Response200
{  "status": "success",  "statusCode": 200,  "message": "If an account with that email exists, a password reset link has been sent.",  "data": null,  "meta": {    "email_sent_at": "2026-01-31T10:00:00.000Z"  },  "timestamp": "2026-01-31T10:00:00.000Z",  "path": "/api/v1/auth/forgot-password"}