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

# Delete Agent

> Deletes an existing agent

<Warning>
  This action cannot be undone. The agent and all its configuration will be permanently deleted.
</Warning>

## Path Parameters

<ParamField path="agentId" type="string" required>
  The unique identifier of the agent to delete (UUID format)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000 \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const agentId = '123e4567-e89b-12d3-a456-426614174000';

  const response = await fetch(`https://api.telzino.com/v1/agents/${agentId}`, {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN' }
  });

  const { success, message } = await response.json();
  console.log(message); // "Agent deleted successfully"
  ```

  ```python Python theme={null}
  import requests

  agent_id = '123e4567-e89b-12d3-a456-426614174000'

  response = requests.delete(
      f'https://api.telzino.com/v1/agents/{agent_id}',
      headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
  )

  result = response.json()
  print(result['message'])  # "Agent deleted successfully"
  ```
</RequestExample>

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

  ```json 403 theme={null}
  {
    "error": "forbidden",
    "error_description": "Access denied"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "not_found",
    "error_description": "Agent not found or access denied"
  }
  ```
</ResponseExample>

## What Gets Deleted

When you delete an agent, the following are removed:

* Agent configuration (name, prompts, voice settings, etc.)
* Extension configurations (webhook tools, MCP servers)
* Integration configurations (calendar, modmed connections)
* SIP registration data (if configured)

<Info>
  **Call logs are NOT deleted.** Historical call transcripts and recordings remain accessible for reporting and compliance purposes.
</Info>

## Alternative: Deactivate Instead

If you want to temporarily disable an agent without deleting it, use the [Update Agent](/api-reference/agents/update) endpoint to set `status` to `inactive`:

```bash theme={null}
curl -X PUT https://api.telzino.com/v1/agents/{agentId} \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "inactive"}'
```