---
title: "Delete Phone Number"
method: DELETE
path: "/v1/phone-numbers/{phoneNumber}"
tags: ["Phone Numbers"]
---

# Delete Phone Number

`DELETE /v1/phone-numbers/{phoneNumber}`

## Request

- Base URL: `https://api.sigmamind.ai`
- URL: `https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}`
- Auth: API key in header `X-API-Key`

Permanently removes a phone number from your account — provisioned numbers are released to the carrier, BYO numbers remain with your telecom provider. Cannot be undone. Returns 204 No Content on success.

## Path parameters

- `phoneNumber` string, required

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/sigmamind/apis/sigmamind-apis.md) - [All operations](https://skmtc.dev/sigmamind/apis/sigmamind-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmamind/apis/sigmamind-apis/revisions/783c9e4c5126?raw)
