PATCH Atualizar Usuário

Atualiza os dados de um usuário existente. Todos os campos são opcionais, exceto o id. Se password for enviado, é re-hasheado.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Permissão necessária

Exige a permissão update_users.

---

Endpoint

PATCH https://api-dev.imagemais.com.br/api/users

---

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
id	number	✅	ID do usuário a atualizar
name	string	❌	Nome completo (mínimo 5 caracteres)
email	string	❌	E-mail válido
password	string	❌	Nova senha forte (mínimo 8 caracteres)
phone	string	❌	Telefone
council	object	❌	Conselho profissional: { type, code, uf }

Roles não entram aqui

Para alterar as roles do usuário, use a rota Atualizar Roles do Usuário (PATCH /users/roles).

---

Requisição

curl -X 'PATCH' \
  'https://api-dev.imagemais.com.br/api/users' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {accessToken}' \
  -d '{
  "id": 12,
  "name": "João da Silva Júnior",
  "phone": "(81) 97777-6666"
}'

---

Respostas

200 Sucesso

Retorna o usuário atualizado (sem password), com council.

{
  "id": 12,
  "accountId": 3,
  "name": "João da Silva Júnior",
  "email": "joao.silva@example.com",
  "phone": "(81) 97777-6666",
  "statusId": 1,
  "isCollector": false,
  "createdAt": "2026-07-01T13:20:00.000Z",
  "updatedAt": "2026-07-21T14:05:00.000Z",
  "council": { "id": 4, "type": "CRM", "code": "12345", "uf": "PE" }
}

404 Usuário não encontrado

{
  "statusCode": 404,
  "message": "Usuário não encontrado"
}