---
title: "Delete Agent"
method: DELETE
path: "/api/v1/agents/{agent_id}"
tags: ["Agents"]
---

# Delete Agent

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

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/v1/agents/{agent_id}`
- Auth: none declared

Delete an agent. Answers 409 while the agent is on a live call (hang it up first) and 409 for a platform template, which cannot be deleted.

## Path parameters

- `agent_id` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `409`: The agent is on a live call (hang it up first), or it is a platform template and cannot be deleted.
- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)