> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lacy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Release phone number

> Release a phone number and cancel its subscription

This endpoint releases a phone number from your account. For dedicated numbers with subscriptions, this cancels the subscription and the number will be released at the end of the current billing period.

### Path Parameters

**id** `integer` *required*

The unique identifier of the phone number to release

### Response

**message** `string`

Success message indicating the release status

```json 200 Subscription Cancelled theme={null}
{
  "message": "Phone number released successfully. It will be removed at the end of the billing period."
}
```

```json 200 Immediately Deleted theme={null}
{
  "message": "Phone number deleted successfully."
}
```

```json 400 Already Scheduled theme={null}
{
  "error": "Phone number is already scheduled for release."
}
```

```json 404 Not Found theme={null}
{
  "error": "Phone number not found."
}
```

```json 500 Error theme={null}
{
  "error": "Failed to release phone number. Please try again or contact support."
}
```

### Release Behavior

The release behavior depends on the phone number type:

| Type | Behavior |
| - | - |
| **Dedicated (normal)** | Subscription is cancelled. Number remains active until the end of the billing period, then is released. |
| **SIP** | Immediately deleted from your account. |
| **Caller ID** | Immediately deleted from your account and removed from the telephony provider. |

> [!WARNING]
>
> Once a phone number is released, you may not be able to get the same number back. Make sure to update any assistants or campaigns using this number before releasing it.

### What Happens to Attached Resources

When you release a phone number:

* Any **inbound assistants** attached to this number will have their phone number unassigned
* Any **campaigns** using this number will have it removed from their phone number rotation
* **Call history** is preserved and remains accessible


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.