auth.password_reset
Define nova senha com link ou código. Aceita {token, password} (token do link recebido por e-mail) ou {email, code, password} (código de 6 dígitos do mesmo e-mail). Encerra as outras sessões e avisa por e-mail. O código tem limite de 5 tentativas por e-mail e 10 por IP por hora.
- Endpoint:
POST https://app.atomiks.com.br/api/v1/auth.password_reset(corpo JSON) - Quem pode chamar: pública (sem chave nem sessão)
- Escopo da chave: nenhum (qualquer chave serve)
- Grava dados: sim
- Pela chave de API: não (pública, sem chave)
- Ferramenta MCP: não
- Ficha em JSON:
https://app.atomiks.com.br/api/v1/openapi.json(operationIdauth.password_reset)
Entrada
Sem campos: envie {}.
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"type": "object",
"properties": {
"token": {
"type": "string",
"minLength": 20
},
"password": {
"type": "string",
"minLength": 8
}
},
"required": [
"token",
"password"
]
},
{
"type": "object",
"properties": {
"email": {
"type": "string"
},
"code": {
"type": "string",
"pattern": "^\\d{6}$"
},
"password": {
"type": "string",
"minLength": 8
}
},
"required": [
"email",
"code",
"password"
]
}
]
}Exemplo
curl -X POST https://app.atomiks.com.br/api/v1/auth.password_reset \
-H "Content-Type: application/json" \
-d '{"token":"token-do-link-recebido-por-email","password":"minha-senha-nova-123"}'Saída
Sucesso: {"data": ...} com o formato abaixo.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"email": {
"type": "string"
}
},
"required": [
"email"
],
"additionalProperties": false
}Erros
{"error": {"code", "message", "requestId"}}. Códigos: invalid_input (400), unauthorized (401), forbidden / account_pending / scope_missing (403), not_found (404), limit_reached (409), internal (500).