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

> Excluir um dado de treinamento específico de um agente

# 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

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

<ParamField path="training" type="string" required>
  O identificador único do treinamento. Você pode encontrá-lo na lista de treinamentos 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 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"
  ```

  ```javascript theme={null}
  // Requisição 1: Excluir um treinamento específico
  const response = await fetch('https://app.talkover.ai/api/v1/agents/agent-uuid-1/trainings/training-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 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"
  ```

  ```javascript theme={null}
  // Requisição 2: Excluir treinamento com IDs específicos
  const agent_id = '550e8400-e29b-41d4-a716-446655440000';
  const training_id = '660e8400-e29b-41d4-a716-446655440000';
  const response = await fetch(`https://app.talkover.ai/api/v1/agents/${agent_id}/trainings/${training_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": "Treinamento excluído 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": "Training 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         |
| `TRAINING_NOT_FOUND` | Treinamento especificado 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 o treinamento.
</Warning>

<Info>
  **Impacto no desempenho.** Remover treinamentos pode afetar o desempenho do agente.
</Info>

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

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

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