Auth API reference

Auth API · Consumer-Auth

post/{app_slug}/v1/auth/send-password-reset-emailAuth

Mint + dispatch a password-reset email via Mail (PAK-required)

Same shape as `send-verification-email` but for the reset slot. PAK perm: `auth.user.password-reset.send-email`. Same loud precondition errors. Email-only.

Path parameters

app_slug*string

Slug of the app.

Request body

email*string

Email contact value to send the password-reset code to.

Example: "jane@example.com"

Response · 201 `{ expires_at }` on success; `{}` on no-match.

expires_at*string

Code expiry, ISO 8601. The plaintext code is NOT returned — Mail has dispatched it.

Example: "2026-05-09T17:30:00.000Z"

Example

Request

POST https://api.auth.productcraft.co/{app_slug}/v1/auth/send-password-reset-email
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "email": "jane@example.com"
}

Response

{
  "expires_at": "2026-05-09T17:30:00.000Z"
}