PATCH Atualizar Usuário
Atualiza os dados de um usuário da clínica. Todos os campos são opcionais, exceto o id. Nome e senha são aplicados também no provedor de identidade (a senha de login muda de fato). Roles não são alteradas aqui — use Atualizar Roles do Usuário.
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Exige a permissão update_users.
O campo email não é aceito: se enviado, é ignorado.
Nome, senha, telefone e conselho profissional pertencem à pessoa e valem em todas as clínicas dela. Se ela tem vínculo ativo em outra clínica, tentar mudar esses dados retorna 403 — só a própria pessoa os troca. Enviar o valor que já está salvo não conta como mudança. Convite pendente não trava.
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) |
password | string | ❌ | Nova senha forte (mínimo 8 caracteres). Vazia é ignorada |
phone | string | ❌ | Telefone |
council | object | ❌ | Conselho profissional: { type, code, uf } |
Requisição
curl -X 'PATCH' \n 'https://api-dev.imagemais.com.br/api/users' \n -H 'accept: application/json' \n -H 'Authorization: Bearer {accessToken}' \n -H 'Content-Type: application/json' \n -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"
}
}
400 Requisição inválida
Validação dos campos, senha fraca ou já exposta (Senha fraca ou já exposta em vazamentos; escolha outra.) ou Esse usuário ainda não tem acesso pelo novo login.
{
"message": "Esse usuário ainda não tem acesso pelo novo login.",
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão ou dado da pessoa em outra clínica
Sem a permissão update_users (Permissões insuficientes) ou tentativa de mudar dados que a pessoa compartilha com outra clínica:
{
"message": "Essa pessoa também acessa outra clínica; nome e senha só podem ser trocados por ela, na tela de login.",
"error": "Forbidden",
"statusCode": 403
}
404 Usuário não encontrado
{
"message": "Usuário não encontrado",
"error": "Not Found",
"statusCode": 404
}
503 Serviço de login indisponível
{
"message": "Não foi possível falar com o serviço de login. Tente novamente em instantes.",
"error": "Service Unavailable",
"statusCode": 503
}