---
title: "POST /_system/passwordreset/request - Password Reset · RUAL Documentation"
description: "Request a password reset token via email"
canonical: https://docs.rual.nl/cluster/api/password-reset/system-passwordreset-request-post
language: en
---

# POST /_system/passwordreset/request

Request a password reset token via email

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **email** required | `string` | `"joe@example.com"` | Email address of the account |
| **host** required | `string` | `"test-blueprints.rual.dev"` | Host URL for the reset link |
| **username** required | `string` | `"joe"` | Username of the account |

```
{
  "msg": "ok"
}
```

```
{
  "error": "ERROR_KEY"
}
```

| Permission | Description |
| --- | --- |
| `*public` | No authentication required, public endpoint |
