---
title: "Set a new password with the link's token, and sign in"
method: POST
path: "/v1/auth/reset"
---

# Set a new password with the link's token, and sign in

`POST /v1/auth/reset`

## Request

- Base URL: `https://api.octapi.app`
- URL: `https://api.octapi.app/v1/auth/reset`
- Auth: HTTP bearer

## Request body

- object
  - `token` string, required
  - `password` string, required

## Response `200`

Default Response

- object
  - `staff` object, required
    - `id` string, required
    - `name` string, required
    - `email` string, required
    - `role` 'agent' | 'admin', required
    - `grants` string[]

---

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