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
required

UUID do avatar a ser deletado.

host_id
string
required

UUID 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ódigoDescrição
400Campos obrigatórios ausentes ou inválidos
403Token ausente ou inválido
404Avatar não encontrado ou não pertence ao host
408Timeout — requisição excedeu 60 segundos
500Erro interno do servidor

Notas

  • Operação de soft delete (remoção lógica).
  • Requer token Bearer no header Authorization.