Pular para o conteúdo principal
DELETE
/
api
/
v1
/
agents
/
{agent_id}
# Requisição 1: Excluir um agente específico
curl -X DELETE "https://app.talkover.ai/api/v1/agents/agent-uuid-1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "message": "Agente excluído com sucesso"
}

​
Excluir Agente

Excluir um agente específico permanentemente. Esta operação não pode ser desfeita e remove todos os dados associados ao agente.

​
Endpoint

DELETE /api/v1/agents/{agent_id}

​
Parâmetros de caminho

​
agent
string
obrigatório
O identificador único do agente. Você pode encontrá-lo na lista de agentes.

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

​
Exemplos de Requisição

# Requisição 1: Excluir um agente específico
curl -X DELETE "https://app.talkover.ai/api/v1/agents/agent-uuid-1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

# Requisição 2: Excluir agente com ID específico
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Resposta

​
Resposta de Sucesso (200 OK)

{
  "success": true,
  "message": "Agente excluído com sucesso"
}

​
Campos da Resposta

​
success
boolean
obrigatório
Indica se a operação foi bem-sucedida.
​
message
string
obrigatório
Mensagem de sucesso descrevendo a operação.

​
Respostas de erro

​
404 Não Encontrado

{
  "success": false,
  "message": "Agent not found"
}

​
409 Conflito

{
  "success": false,
  "message": "Cannot delete agent that is currently in use"
}

​
401 Não Autorizado

{
  "success": false,
  "message": "Unauthorized"
}

​
500 Erro do Servidor

{
  "success": false,
  "message": "Internal server error."
}

​
Códigos de erro

CódigoDescriçãoStatus HTTP
AGENT_NOT_FOUNDAgente especificado não existe404
AGENT_IN_USEAgente não pode ser excluído pois está em uso409
INVALID_TOKENToken de autenticação inválido ou ausente401
SERVER_ERRORErro interno do servidor ocorreu500

​
Notas Importantes

Operação irreversível. Esta operação exclui permanentemente o agente e todos os dados associados.
Verificação de uso. Agentes em uso ativo não podem ser excluídos.
Dados associados. Todos os dados do agente, incluindo treinamentos e ações, são removidos.
Confirmação necessária. Certifique-se de que deseja excluir o agente antes de executar esta operação.

​
Melhores Práticas

  1. Confirme a exclusão - Certifique-se de que deseja excluir o agente permanentemente
  2. Verifique uso ativo - Confirme que o agente não está sendo usado em chamadas ativas
  3. Faça backup - Considere fazer backup dos dados importantes antes da exclusão
  4. Teste em ambiente de desenvolvimento - Teste a exclusão em ambiente de desenvolvimento primeiro
  5. Monitore dependências - Verifique se há outras partes do sistema que dependem do agente

​
Endpoints relacionados

  • Listar Agentes: GET /api/v1/agents
  • Obter Agente: GET /api/v1/agents/{agent_id}
  • Criar Agente: POST /api/v1/agents
  • Atualizar Conhecimento do Agente: PUT /api/v1/agents/{agent_id}/knowledge