> For the complete documentation index, see [llms.txt](https://docs.gestao.plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gestao.plus/api/public/password_recovery.md).

# Recuperar Senha

## Recuperar Senha

<mark style="color:green;">`POST`</mark> `https://api.gestao.plus/user?q=recovery-password`

Esta rota permite que o usuário altere a sua senha com o token e prefixo retornados anteriormente durante a solicitação.

#### Query Parameters

| Name                                | Type   | Description         |
| ----------------------------------- | ------ | ------------------- |
| q<mark style="color:red;">\*</mark> | string | "recovery-password" |

#### Request Body

| Name                                        | Type   | Description                            |
| ------------------------------------------- | ------ | -------------------------------------- |
| password<mark style="color:red;">\*</mark>  | string | Nova senha                             |
| pinPrefix<mark style="color:red;">\*</mark> | string | Prefixo recebido juntamente com o PIN  |
| pin<mark style="color:red;">\*</mark>       | string | PIN recebido por email ou sms          |
| token<mark style="color:red;">\*</mark>     | string | O seu token para recuperação da senha. |

{% tabs %}
{% tab title="202 " %}

```
{
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "title": "Unknown",
    "status": 202,
    "detail": {
        "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
        "title": "Password Recovery",
        "status": 202,
        "detail": "Password changed"
    }
}
```

{% endtab %}

{% tab title="400 " %}

```
{
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "title": "Bad Request",
    "status": 400,
    "detail": "Invalid recovery password pin/token"
}
```

{% endtab %}
{% endtabs %}