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

# Release number

> Release a phone number and cancel its subscription.

Releases a phone number from your account. For dedicated numbers, this cancels the subscription and the number is released at the end of the current billing period.

## Endpoint

`DELETE /user/phone-numbers/{id}`

## Path parameters

<ParamField path="id" type="integer" required>
  Unique identifier of the phone number to release.
</ParamField>

## Response

<ResponseField name="message" type="string">
  Confirmation message indicating the release status.
</ResponseField>

## Release behavior

| 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.                          |

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://portal.intellixent.ai/api/user/phone-numbers/123" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://portal.intellixent.ai/api/user/phone-numbers/123', {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });

  const data = await response.json();
  console.log(data.message);
  ```
</CodeGroup>

```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 404 Not found theme={null}
{
  "error": "Phone number not found."
}
```

<Warning>
  Once released, you may not be able to reclaim the same number. Update any assistants or campaigns using this number before releasing it.
</Warning>

When you release a phone number:

* Inbound assistants assigned to this number will have the number unassigned.
* Campaigns using this number will have it removed from their rotation.
* Call history is preserved and remains accessible.