---
title: "Delete Custom Phone Number"
method: DELETE
path: "/agents/{nameOrId}/custom-phone-numbers"
tags: ["agents"]
---

# Delete Custom Phone Number

`DELETE /agents/{nameOrId}/custom-phone-numbers`

Deletes a custom phone number from an agent.

## Path parameters

- `nameOrId` string, required

## Query parameters

- `project` string

## Headers

- `Authorization` string, required

## Request body

- object
  - `phone_number` string, required — The E.164 formatted phone number to remove (e.g., "+15551234567").

## Response `200`

Success response

- AgentsDeleteCustomPhoneNumberResponse200
  - `success` boolean, required

## Other responses

- `400` — Invalid parameters, phone number not assigned to agent, or not a custom phone number
- `401` — Unsupported authentication method
- `403` — Forbidden
- `404` — Agent or phone number not found
- `409` — The agent is currently being updated. Please try again.

---

[API](https://skmtc.net/phonic/apis/api-reference.md) · [All operations](https://skmtc.net/phonic/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phonic/api-reference/revisions/7f8c81a5a990/schema)