---
title: "Delete an agent"
method: DELETE
path: "/companies/{company}/agents/{agent}"
tags: ["AI Agent"]
---

# Delete an agent

`DELETE /companies/{company}/agents/{agent}`

Only assignments the agent still answers on block the delete. Assignments that are paused — AI IVR
switched off, or the agent's leg closed inside the routing — are detached first, the same way
unassigning one at a time would, so nothing keeps pointing at an agent that no longer exists.

## Path parameters

- `company` integer, required
- `agent` integer, required

## Response `200`

Agent deleted successfully

- object
  - `message` string

## Other responses

- `404` — Agent not found
- `422` — Cannot delete agent (still answering on one or more assignments)

---

[API](https://skmtc.dev/800/apis/public-api.md) · [All operations](https://skmtc.dev/800/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/800/public-api/revisions/b4b302ac9e83/schema)