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

# Delete Training

> Delete a specific training data entry for a voice agent

# Delete Training

Delete a specific training data entry for a voice agent. This action is irreversible and will permanently remove the training instructions from the agent.

## Endpoint

```
DELETE /api/v1/agents/{agent_id}/trainings/{training_id}
```

## Path parameters

<ParamField path="agent" type="string" required>
  The unique identifier of the voice agent.
</ParamField>

<ParamField path="training" type="string" required>
  The unique identifier of the training to delete. You can find this by listing the agent's trainings first.
</ParamField>

## Request headers

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication. Format: `Bearer talq_your_environment_token_here`
</ParamField>

## Example requests

<RequestExample>
  ```bash theme={null}
  # Request 1: Delete a specific training
  curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings/training-uuid-1" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```

  ```javascript theme={null}
  // Request 1: Delete a specific training
  const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/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}
  # Request 2: Delete training with error handling
  curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings/training-uuid-1" \
    -H "Authorization: Bearer talq_your_environment_token_here" \
    -w "\nHTTP Status: %{http_code}\n"
  ```

  ```javascript theme={null}
  // Request 2: Delete training with error handling
  try {
    const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings/training-uuid-1', {
      method: 'DELETE',
      headers: {
        'Authorization': 'Bearer talq_your_environment_token_here'
      }
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const result = await response.json();
    console.log('Training deleted successfully:', result.message);
  } catch (error) {
    console.error('Error deleting training:', error);
  }
  ```
</RequestExample>

## Response

### Success Response (200 OK)

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "message": "Agent training deleted successfully"
  }
  ```
</ResponseExample>

### Response fields

<ResponseField name="success" type="boolean" required>
  Indicates if the operation was successful.
</ResponseField>

<ResponseField name="message" type="string" required>
  Success message confirming the training was deleted.
</ResponseField>

## Error responses

### 404 Not Found

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

### 401 Unauthorized

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

### 403 Forbidden

<ResponseExample>
  ```json theme={null}
  {
    "success": false,
    "message": "You are not authorized to delete training for this agent."
  }
  ```
</ResponseExample>

### 500 Server Error

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

## Error codes

| Code                 | Description                                                     | HTTP Status |
| -------------------- | --------------------------------------------------------------- | ----------- |
| `TRAINING_NOT_FOUND` | Specified training does not exist                               | 404         |
| `AGENT_NOT_FOUND`    | Specified agent does not exist                                  | 404         |
| `INVALID_TOKEN`      | Authentication token is invalid or missing                      | 401         |
| `UNAUTHORIZED`       | User does not have permission to delete training for this agent | 403         |
| `SERVER_ERROR`       | Internal server error occurred                                  | 500         |

## Important notes

<Warning>
  **This action is irreversible.** Once a training is deleted, it cannot be recovered. Make sure you have a backup if needed.
</Warning>

<Info>
  **Agent status will be set to draft.** After deleting training, the agent will be automatically set to "draft" status and will need to be published again to become active.
</Info>

<Info>
  **No confirmation required.** The deletion happens immediately without additional confirmation steps.
</Info>

## Related endpoints

* **List Trainings**: `GET /api/v1/agents/{agent_id}/trainings`
* **Create/Update Training**: `POST /api/v1/agents/{agent_id}/trainings`
* **Get Agent**: `GET /api/v1/agents/{agent_id}`
* **Publish Agent**: `POST /api/v1/agents/{agent_id}/publish`