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

# Delete Agent

`DELETE /v1/agents/{agent_id}`

Delete an agent.

Phone numbers, conversations, and calls associated with the agent will have their
agent reference cleared (set to null) but will not be deleted themselves.

## Path parameters

- `agent_id` string, required

## Response `200`

Successful Response

- DeleteAgentResponse
  - `success` boolean, required
  - `id` string, required
  - `name` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/versions/5724ccaa33d8/schema)