Pular para o conteúdo principal
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"

{
  "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

​
agent
string
obrigatório
O identificador único do agente. Você pode encontrá-lo na lista de agentes.
​
action
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

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

​
Exemplos 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 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"

​
Resposta

​
Resposta de Sucesso (200 OK)

{
  "success": true,
  "message": "Ação excluída 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": "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ódigoDescriçãoStatus HTTP
AGENT_NOT_FOUNDAgente especificado não existe404
ACTION_NOT_FOUNDAção especificada 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 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

  1. Confirme a exclusão - Certifique-se de que deseja excluir a ação permanentemente
  2. Avalie o impacto - Considere como a remoção pode afetar o comportamento do agente
  3. Faça backup - Considere fazer backup das configurações importantes antes da exclusão
  4. Teste em ambiente de desenvolvimento - Teste a exclusão em ambiente de desenvolvimento primeiro
  5. 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