DELETE/api/users/{id}

Excluir usuário

Apaga o usuário de vez.

  • Exige o token de acesso — como obter
  • Permissão “Excluir usuário” (users.delete)

Headers

NomeTipoObrig.Descrição
Authorization
stringSimBearer {access_token}, com o token que o login devolve.

Parâmetros do caminho

NomeTipoObrig.Descrição
id
uuidSimO usuário.

Request URL

https://api-endosystem.imagemais.com.br/api/users/6a8c0e2b-4d6f-4a8b-9c1e-3f5a7b9d1c3e
curl -X DELETE "https://api-endosystem.imagemais.com.br/api/users/6a8c0e2b-4d6f-4a8b-9c1e-3f5a7b9d1c3e" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Respostas

{
  "message": "Usuário removido"
}
{
  "message": "Usuário removido"
}
{
  "error": "ID inválido"
}
{
  "error": "ID inválido"
}
{
  "error": "A clínica precisa de pelo menos uma pessoa ativa que gerencie os grupos.",
  "code": "ultimo_admin"
  ...
{
  "error": "A clínica precisa de pelo menos uma pessoa ativa que gerencie os grupos.",
  "code": "ultimo_admin"
}
{
  "error": "Este usuário já tem registros no sistema e não pode ser excluído. Desative-o para tirar o acesso.",
  "code": "usuario_com_historico"
  ...
{
  "error": "Este usuário já tem registros no sistema e não pode ser excluído. Desative-o para tirar o acesso.",
  "code": "usuario_com_historico"
}
{
  "error": "Usuário não encontrado"
}
{
  "error": "Usuário não encontrado"
}
{
  "error": "Você não tem a permissão \"Excluir usuário\".",
  "code": "sem_permissao"
  ...
{
  "error": "Você não tem a permissão \"Excluir usuário\".",
  "code": "sem_permissao"
}
{
  "error": "Funcionalidade não contratada",
  "message": "Esta funcionalidade não está habilitada para a sua clínica.",
  ...
{
  "error": "Funcionalidade não contratada",
  "message": "Esta funcionalidade não está habilitada para a sua clínica.",
  "code": "FEATURE_NOT_ENABLED"
}
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...
{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...
{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...
{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...
{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}
{
  "error": "Erro interno do servidor"
}
{
  "error": "Erro interno do servidor"
}