Redefinir Senha de Usuário

POST /api/auth/reset-user-password

Redefine a senha de outro usuário. Requer a permissão user:reset-password e o usuário-alvo deve estar em um nível de função inferior ao do usuário solicitante (aplicação da hierarquia de funções).

Auth: Necessária — permissão user:reset-password

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`userId`	UUID	Sim	ID do usuário cuja senha será redefinida
`newPassword`	string	Sim	Nova senha (mínimo de 8 caracteres)

Exemplo

curl -X POST https://api.reten.ai/api/auth/reset-user-password \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "newPassword": "NewSecurePass456!"
  }'

const response = await fetch("https://api.reten.ai/api/auth/reset-user-password", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    userId: "550e8400-e29b-41d4-a716-446655440000",
    newPassword: "NewSecurePass456!",
  }),
});

import requests

response = requests.post(
    "https://api.reten.ai/api/auth/reset-user-password",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
    json={
        "userId": "550e8400-e29b-41d4-a716-446655440000",
        "newPassword": "NewSecurePass456!",
    },
)

Resposta `201 Created`

{
  "message": "Password updated successfully"
}

Respostas de Erro

Status	Descrição
`400`	Erro de validação — `userId` não é um UUID, ou `newPassword` tem menos de 8 caracteres
`403`	O alvo é o próprio usuário atual — `Use the reset-my-password endpoint to reset your own password`
`403`	O usuário-alvo não pertence ao tenant ativo — `Cannot reset password for user outside your active tenant`
`403`	A função do usuário-alvo é igual ou superior à do usuário atual — `Cannot reset password for user with equal or higher role`
`404`	`User not found`