Skip to main content

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.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão update_users.

E-mail não é editável

O campo email não é aceito: se enviado, é ignorado.

Quem atende em mais de uma clínica

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​

CampoTipoObrigatórioDescrição
idnumber✅ID do usuário a atualizar
namestring❌Nome completo (mínimo 5 caracteres)
passwordstring❌Nova senha forte (mínimo 8 caracteres). Vazia é ignorada
phonestring❌Telefone
councilobject❌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
}