> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Excluir Ação

> Excluir uma ação específica de um agente

# 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

<ParamField path="agent" type="string" required>
  O identificador único do agente. Você pode encontrá-lo na lista de agentes.
</ParamField>

<ParamField path="action" type="string" required>
  O identificador único da ação. Você pode encontrá-lo na lista de ações do agente.
</ParamField>

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos de Requisição

<RequestExample>
  ```bash theme={null}
  # 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"
  ```

  ```javascript theme={null}
  // 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);
  ```
</RequestExample>

<RequestExample>
  ```bash theme={null}
  # 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"
  ```

  ```javascript theme={null}
  // 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);
  ```
</RequestExample>

## Resposta

### Resposta de Sucesso (200 OK)

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "message": "Ação excluída com sucesso"
  }
  ```
</ResponseExample>

### Campos da Resposta

<ResponseField name="success" type="boolean" required>
  Indica se a operação foi bem-sucedida.
</ResponseField>

<ResponseField name="message" type="string" required>
  Mensagem de sucesso descrevendo a operação.
</ResponseField>

## Respostas de erro

### 404 Não Encontrado

<ResponseExample>
  ```json theme={null}
  {
    "success": false,
    "message": "Agent not found"
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": false,
    "message": "Action not found"
  }
  ```
</ResponseExample>

### 401 Não Autorizado

<ResponseExample>
  ```json theme={null}
  {
    "success": false,
    "message": "Unauthorized"
  }
  ```
</ResponseExample>

### 500 Erro do Servidor

<ResponseExample>
  ```json theme={null}
  {
    "success": false,
    "message": "Internal server error."
  }
  ```
</ResponseExample>

## 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

<Warning>
  **Operação irreversível.** Esta operação exclui permanentemente a ação.
</Warning>

<Info>
  **Impacto no comportamento.** Remover ações pode afetar o comportamento do agente.
</Info>

<Info>
  **Verificação de existência.** O sistema verifica se tanto o agente quanto a ação existem.
</Info>

<Warning>
  **Confirmação necessária.** Certifique-se de que deseja excluir a ação antes de executar esta operação.
</Warning>

## 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`