---
title: "Release Phone Number"
api: "POST /v1/api/twilio/release-number"
description: "Release (cancel) a phone number from your workspace."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

## Headers
<ParamField header="x-workspace-id" type="string" required>
Workspace identifier for the API.
</ParamField>

## Request Body

<ParamField body="phoneNumberId" type="string" required>
The unique identifier of the phone number to release.
</ParamField>

## Response Fields

<ResponseField name="success" type="boolean">
Whether the release was successful.
</ResponseField>

<ResponseField name="message" type="string">
Confirmation message.
</ResponseField>

<ResponseExample>
```json
{
  "success": true,
  "message": "Phone number released successfully"
}
```
</ResponseExample>