Excluir cliente
Remove um usuário da loja por exclusão lógica, preservando pedidos e histórico.
Use esta operação quando um cadastro não deve mais existir para a loja: uma conta duplicada, um pedido de remoção de dados atendido pelo suporte, um teste. A exclusão é lógica: o registro ganha uma data de exclusão, o status passa a D, as sessões abertas morrem e os números de WhatsApp ligados à conta são soltos. Pedidos, endereços e histórico continuam guardados e ligados ao id.
Depois de excluído, o usuário não aparece nas listas, a consulta responde 404 e o e-mail volta a ficar livre para um novo cadastro. Se você só quer impedir o acesso e poder voltar atrás, desative o usuário em vez de excluir.
/api/v1/admin/users/{id}AdminExclui um usuário
Exige manage_users. Não há corpo na requisição.
Path parameters
iduuidobrigatórioId do usuário.
Exemplo de requisição
bash
curl -X DELETE "$BASE_URL/api/v1/admin/users/8ca9b95c-89d4-40d1-afc7-e32a870a569b" \
-H "Authorization: Bearer $TOKEN"Resposta
200Usuário excluído
json
{ "message": "user deleted" }Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Sem credenciais, chave inválida ou token expirado | {"error":"invalid or expired token"} |
| 403 | Faltar manage_users | {"error":"insufficient privileges","required":"manage_users"} |
| 404 | Usuário não existe ou já foi excluído | {"error":"user not found"} |
| 500 | Id que não é UUID | {"error":"failed to delete user","detail":"..."} |