# 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 1: Excluir um agente específico
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Agente excluído com sucesso"
}
Agentes
Excluir Agente
Excluir um agente específico permanentemente
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"
// Requisição 1: Excluir um agente específico
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"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
string
obrigatório
O identificador único do agente. Você pode encontrá-lo na lista de agentes.
Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereExemplos 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 1: Excluir um agente específico
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# 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"
// Requisição 2: Excluir agente com ID específico
const agent_id = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(`https://app.talkover.ai/api/v1/agents/${agent_id}`, {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
Resposta
Resposta de Sucesso (200 OK)
{
"success": true,
"message": "Agente excluído com sucesso"
}
Campos da Resposta
boolean
obrigatório
Indica se a operação foi bem-sucedida.
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ódigo | Descrição | Status HTTP |
|---|---|---|
AGENT_NOT_FOUND | Agente especificado não existe | 404 |
AGENT_IN_USE | Agente não pode ser excluído pois está em uso | 409 |
INVALID_TOKEN | Token de autenticação inválido ou ausente | 401 |
SERVER_ERROR | Erro interno do servidor ocorreu | 500 |
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
- Confirme a exclusão - Certifique-se de que deseja excluir o agente permanentemente
- Verifique uso ativo - Confirme que o agente não está sendo usado em chamadas ativas
- Faça backup - Considere fazer backup dos dados importantes antes da exclusão
- Teste em ambiente de desenvolvimento - Teste a exclusão em ambiente de desenvolvimento primeiro
- 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
Esta página foi útil?