---
title: "Release phone number"
method: DELETE
path: "/v1/phone-numbers/{phoneNumberId}"
---

# Release phone number

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

## Request

- Base URL: `https://api.zavu.dev`
- URL: `https://api.zavu.dev/v1/phone-numbers/{phoneNumberId}`
- Auth: HTTP bearer

Release a phone number. The phone number must not be assigned to a sender.

## Path parameters

- `phoneNumberId` string, required

## Response `204`

Phone number released.

## Other responses

- `400`: Cannot release phone number assigned to a sender.
- `401`: Unauthorized.
- `404`: Phone number not found.

---

[API](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api.md) - [All operations](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/revisions/75bc777b0ffb?raw)