Avatares
Deletar Avatar
Remove um avatar (soft delete).
Endpoints Disponíveis
Endpoint Atual (Legado)
DELETE /api/externalAPIs/public/tolkyReasoning/avatars/delete/{avatar_id}
Nova Rota (Recomendada)
POST /api/externalAPIs/public/tolkyReasoning/avatars/deleteAvatarHelper
Parâmetros
Rota legado: avatar_id no path da URL.
Nova rota:
avatar_id
string
requiredUUID do avatar a ser deletado.
host_id
string
requiredUUID do host proprietário do avatar.
Exemplo
Rota legado:
curl -X DELETE \
'{{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/avatars/delete/{avatar_id}' \
-H 'Authorization: Bearer {TOKEN}' \
-H 'Content-Type: application/json'
Nova rota (recomendada):
curl -X POST \
'{{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/avatars/deleteAvatarHelper' \
-H 'Authorization: Bearer {TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"avatar_id": "uuid-do-avatar",
"host_id": "uuid-do-host"
}'
Resposta
{
"code": 200,
"message": "Avatar deleted successfully"
}
Erros
| Código | Descrição |
|---|---|
400 | Campos obrigatórios ausentes ou inválidos |
403 | Token ausente ou inválido |
404 | Avatar não encontrado ou não pertence ao host |
408 | Timeout — requisição excedeu 60 segundos |
500 | Erro interno do servidor |
Notas
- Operação de soft delete (remoção lógica).
- Requer token Bearer no header Authorization.