Solicitar redefinição de senha

POST

/password/resetPassword

Solicita a redefinição de senha de um acesso à plataforma. Informe em credential o e-mail ou o CPF cadastrado. Se a credencial corresponder a um acesso ativo, a plataforma envia para o e-mail cadastrado um link para definir a nova senha, que é usado na rota de definir senha pelo link recebido por e-mail. A rota aceita no máximo 5 solicitações por minuto de uma mesma origem; acima disso, responde 429 (Too many requests, please try again later.) e informa no header Retry-After quantos segundos esperar. Os headers RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset acompanham as respostas. Rota pública: não exige Bearer JWT nem x-api-key.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Solicitação recebida

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Credencial não informada

🟠429Limite de solicitações excedido

Request Example

Shell

JavaScript

Java

Swift

curl --location '/password/resetPassword' \
--header 'Content-Type: application/json' \
--data-raw '{
    "credential": "maria.souza@example.com"
}'

Response Example

200 - Sucesso

{
    "formURL": "Se as credenciais estiverem cadastradas, você receberá as instruções de redefinição em instantes."
}

Modificado em 2026-10-13 09:47:06

Página anterior

Remover etiqueta personalizada de uma empresa

Próxima página

Listar imóveis rurais detalhados de um cliente