---
title: "Delete phone numbers from a project"
method: DELETE
path: "/v1/agents/{agentId}/telephony/phone-numbers"
tags: ["Phone Numbers"]
---

# Delete phone numbers from a project

`DELETE /v1/agents/{agentId}/telephony/phone-numbers`

## Request body

- DeletePhoneNumbersBody — Phone numbers to release in a single call. Releases are processed independently; see the response for per-number results.
  - `phoneNumbers` string[], required — List of phone numbers to delete

## Response `200`

Successful response

- DeletePhoneNumbersResponse — Per-number results of a batch release — phone numbers that were successfully released, plus any that couldn't be and why.
  - `deleted` string[], required — Successfully deleted phone numbers
  - `errors` DeletePhoneNumberErrorItem[] — Per-number errors (omitted when empty)
    - `phoneNumber` string, required
    - `error` string, required

## Other responses

- `400` — Validation error
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – insufficient permissions

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/versions/76f3c606e395/schema)