# Request Password Reset

`POST /gate/password-reset/request` · Identity & Access · Sign-in & Sessions

Initiates a password reset flow for the specified email address by dispatching a single-use reset token. The reset token has a 1-hour TTL.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `email` | string (email) | yes | The address to send the reset code to. The response is the same whether or not an active end user has this address; a code is only emailed when one does. |

```json
{
  "email": "jane@demo.example"
}
```

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes | The result of the reset request. If the address belongs to an end user of the project, a reset code is emailed to it. |
| `data.reset` | object | yes | The reset request was accepted. The answer is the same for every address. |
| `data.reset.requested` | enum (true) | yes | Always `true`, whether or not the address belongs to an end user, so the response does not reveal who is registered. |
| `data.reset.expiresAt` | string (date-time) | yes | When the reset code expires, one hour from now. Present for every address, registered or not. |
| `data.debugToken` | string | no | The reset code itself. Only in a test deployment that turns this on; a production deployment never includes it. |
| `meta` | object | yes | Request metadata: cost, timing and the request and trace ids. |


## Errors

| HTTP | Code | When |
|---|---|---|
| 404 | `K9O_END_USER_NOT_FOUND` | No account was found for the provided email address. |

## Code samples

### cURL

```bash
curl -X POST 'https://<org>.api-<region>.k9o.io/@storefront/gate/password-reset/request' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "jane@demo.example"
}'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/gate/password-reset/request', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "email": "jane@demo.example"
}),
});
const { data, meta } = await res.json();
```

### @k9o/core

```typescript
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.gate.passwordReset.request({
  email: 'jane@demo.example'
})
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/identity-access/request-password-reset
