Send password reset

POSThttps://app.speybooks.com/api/v1/admin/users/{id}/send-reset-link

Send a password reset link to a user on their behalf. This is the same reset flow as the self-service forgot-password endpoint: any earlier unused reset link is invalidated and a single-use, time-limited link is issued and emailed to the user.

Returns 404 if the user is not found.

Records a PASSWORD_RESET_SENT action in the audit log.

Error responses:

400 { code: "USER_INACTIVE" }: cannot send to an inactive user
404 { code: "NOT_FOUND" }: user not found

Path parameters

idstringrequired

User ID.

Response

200Reset email sent.

Show response fields

messagestring

Error codes

400User is inactive.

404User not found.

RequestPOST/v1/admin/users/{id}/send-reset-linkcurl

curl -X POST https://api.speybooks.com/v1/admin/users/12/send-reset-link \
  -H "Authorization: Bearer <admin-token>"

Response200

{
  "success": true,
  "data": {
    "message": "Password reset link sent to user@example.com"
  }
}