# Requisição 1: Excluir uma ação específica
curl -X DELETE "https://app.talkover.ai/api/v1/agents/agent-uuid-1/actions/action-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 1: Excluir uma ação específica
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/actions/action-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Ação excluída com sucesso"
}
Ações
Excluir Ação
Excluir uma ação específica de um agente
DELETE
/
api
/
v1
/
agents
/
{agent_id}
/
actions
/
{action_id}
# Requisição 1: Excluir uma ação específica
curl -X DELETE "https://app.talkover.ai/api/v1/agents/agent-uuid-1/actions/action-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 1: Excluir uma ação específica
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/actions/action-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Ação excluída com sucesso"
}
Excluir Ação
Excluir uma ação específica de um agente. Esta operação remove permanentemente a ação e suas configurações.Endpoint
DELETE /api/v1/agents/{agent_id}/actions/{action_id}
Parâmetros de caminho
string
obrigatório
O identificador único do agente. Você pode encontrá-lo na lista de agentes.
string
obrigatório
O identificador único da ação. Você pode encontrá-lo na lista de ações do agente.
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 uma ação específica
curl -X DELETE "https://app.talkover.ai/api/v1/agents/agent-uuid-1/actions/action-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 1: Excluir uma ação específica
const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/actions/action-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# Requisição 2: Excluir ação com IDs específicos
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/660e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Requisição 2: Excluir ação com IDs específicos
const agent_id = '550e8400-e29b-41d4-a716-446655440000';
const action_id = '660e8400-e29b-41d4-a716-446655440000';
const response = await fetch(`https://app.talkover.ai/api/v1/agents/${agent_id}/actions/${action_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": "Ação excluída 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"
}
{
"success": false,
"message": "Action 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ódigo | Descrição | Status HTTP |
|---|---|---|
AGENT_NOT_FOUND | Agente especificado não existe | 404 |
ACTION_NOT_FOUND | Ação especificada não existe | 404 |
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 a ação.
Impacto no comportamento. Remover ações pode afetar o comportamento do agente.
Verificação de existência. O sistema verifica se tanto o agente quanto a ação existem.
Confirmação necessária. Certifique-se de que deseja excluir a ação antes de executar esta operação.
Melhores Práticas
- Confirme a exclusão - Certifique-se de que deseja excluir a ação permanentemente
- Avalie o impacto - Considere como a remoção pode afetar o comportamento do agente
- Faça backup - Considere fazer backup das configurações importantes antes da exclusão
- Teste em ambiente de desenvolvimento - Teste a exclusão em ambiente de desenvolvimento primeiro
- Monitore comportamento - Acompanhe como a remoção afeta o comportamento do agente
Endpoints relacionados
- Listar Ações:
GET /api/v1/agents/{agent_id}/actions - Criar/Atualizar Ação:
POST /api/v1/agents/{agent_id}/actions - Obter Agente:
GET /api/v1/agents/{agent_id} - Listar Agentes:
GET /api/v1/agents
Esta página foi útil?