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

# Release Phone Number

> Releases a phone number and cancels its subscription

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

### Path Parameters

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

### Response Fields

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

### 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 it 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 all assistants or campaigns using this number before releasing it.
</Warning>

### What Happens to Associated Resources

When you release a phone number:

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

<ResponseExample>
  ```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."
  }
  ```
</ResponseExample>

<Tip>
  Related pages: [Introduction](/en/api-reference/introduction) and [Authentication Guide](/en/developers/authentication-guide), and [API Integration Examples](/en/developers/api-integration-examples).
</Tip>