---
title: "Delete a voice agent"
method: DELETE
path: "/v3/voice/agents/{id}"
tags: ["Voice"]
---

# Delete a voice agent

`DELETE /v3/voice/agents/{id}`

## Request

- Base URL: `https://api.sent.dm`
- URL: `https://api.sent.dm/v3/voice/agents/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Removes the agent. Calls it already took keep their `agent_id`.

An agent that one of your voice numbers routes to, or that another of your agents lists in `transfer_targets`, is not deleted: the answer is `409` with a message naming those numbers and agents. Unbind the numbers (`PATCH /v3/channels/voice/{number}` with `"agent_id": null`), take the agent out of the others' `transfer_targets` or delete them, and try again.

With `sandbox: true` nothing is written: the agent is looked up and the answer is the one a real delete would give.

## Path parameters

- `id` string, required

## Headers

- `x-profile-id` string, uuid

## Request body

- SentDmServicesEndpointsCustomerAPIv3VoiceAgentsRequestsDeleteVoiceAgentRequest: Base request for mutation operations (POST, PUT, PATCH) with sandbox mode support
  - `sandbox` boolean: Sandbox flag - when true, the operation is simulated without side effects Useful for testing integrations without actual execution

## Response `204`

Deleted

## Other responses

- `400`: id is not an agent id
- `401`: Unauthorized - Invalid API credentials
- `403`: Forbidden
- `404`: This account has no such agent
- `409`: A voice number routes to this agent, or another of your agents lists it in transfer_targets; the message names them

## Changes

- **2026-10-28** `41acb2ceb84d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/changes/v3/voice/agents/:id/delete.md)

---

[API](https://skmtc.dev/sentdm/apis/sent-dm-api-v3.md) - [All operations](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/revisions/bdcca958cac7?raw)