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

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

​
Excluir Treinamento

Excluir um dado de treinamento específico de um agente. Esta operação remove permanentemente a pergunta e resposta de treinamento.

​
Endpoint

DELETE /api/v1/agents/{agent_id}/trainings/{training_id}

​
Parâmetros de caminho

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

​
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 treinamento específico
curl -X DELETE "https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings/training-uuid-1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

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

​
Resposta

​
Resposta de Sucesso (200 OK)

{
  "success": true,
  "message": "Treinamento 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"
}

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

​
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
TRAINING_NOT_FOUNDTreinamento especificado não existe404
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 treinamento.
Impacto no desempenho. Remover treinamentos pode afetar o desempenho do agente.
Verificação de existência. O sistema verifica se tanto o agente quanto o treinamento existem.
Confirmação necessária. Certifique-se de que deseja excluir o treinamento antes de executar esta operação.

​
Melhores Práticas

  1. Confirme a exclusão - Certifique-se de que deseja excluir o treinamento permanentemente
  2. Avalie o impacto - Considere como a remoção pode afetar o desempenho do agente
  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 desempenho - Acompanhe como a remoção afeta o desempenho do agente

​
Endpoints relacionados

  • Listar Treinamentos: GET /api/v1/agents/{agent_id}/trainings
  • Criar/Atualizar Treinamento: POST /api/v1/agents/{agent_id}/trainings
  • Obter Agente: GET /api/v1/agents/{agent_id}
  • Listar Agentes: GET /api/v1/agents