---
title: "Reset password"
method: POST
path: "/api/auth/passwords/reset"
tags: ["Authentication"]
---

# Reset password

`POST /api/auth/passwords/reset`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/auth/passwords/reset`
- Auth: none declared
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/auth/passwords/reset/post.ts> (a function with typed inputs; its response is checked against the schema)

Resets the user's password using the token received via email. Password must be at least 8 characters with mixed case and symbols.

## Request body

- ResetPasswordRequest
  - `token` string, required: Password reset token from email
  - `email` string, email, required: User's email address
  - `password` string, password, required: New password (min 8 chars, mixed case, with symbols)
  - `password_confirmation` string, password, required: Password confirmation

## Response `200`

Password reset result

- ResetPasswordResponse
  - `status` string: Status indicator (ok or error)
  - `error` object: Error details (only present on failure)
    - `type` string: Error type code
    - `message` string: Human-readable error message

## Other responses

- `422`: Validation error

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)
