DELETE Deletar Usuário
Exclui um usuário da clínica. É um soft delete (preenche deletedAt no vínculo da pessoa com a clínica; nada é removido fisicamente).
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 delete_users.
Efeito no acesso
A exclusão aplica o mesmo bloqueio de Atualizar Status: vínculo desativado, sessões da clínica encerradas e tokens já emitidos recusados. A pessoa e o acesso dela a outras clínicas não são afetados.
Convite pendente
Se o usuário ainda não aceitou o convite para a clínica, a exclusão cancela o convite.
Voltar à clínica
Criar de novo um usuário com o mesmo e-mail reativa o cadastro anterior.
Endpoint
DELETE 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 deletar |
Requisição
curl -X 'DELETE' \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
}'
Respostas
200 Sucesso
{
"message": "Usuario deletado com sucesso",
"status": 200
}
400 Usuário sem 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
{
"message": "Permissões insuficientes",
"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
}