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

# Liberar número de teléfono

> Libera un número de teléfono y cancela su suscripción

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint libera un número de teléfono de tu cuenta. En el caso de los números dedicados con suscripción, esta se cancela y el número se liberará al final del periodo de facturación actual.

### Parámetros de ruta

<ParamField path="id" type="integer" required>
  El identificador único del número de teléfono que se va a liberar
</ParamField>

### Campos de respuesta

<ResponseField name="message" type="string">
  Mensaje de éxito que indica el estado de la liberación
</ResponseField>

### Comportamiento de la liberación

El comportamiento de la liberación depende del tipo de número de teléfono:

| Tipo                          | Comportamiento                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Dedicado (normal)**         | La suscripción se cancela. El número permanece activo hasta el final del periodo de facturación y luego se libera. |
| **SIP**                       | Se elimina inmediatamente de tu cuenta.                                                                            |
| **Identificador de llamadas** | Se elimina inmediatamente de tu cuenta y se retira del proveedor de telefonía.                                     |

<Warning>
  Una vez liberado un número de teléfono, es posible que no puedas recuperar el mismo número. Asegúrate de actualizar todos los asistentes o campañas que usen este número antes de liberarlo.
</Warning>

### Qué ocurre con los recursos asociados

Al liberar un número de teléfono:

* Todos los **asistentes entrantes** asignados a este número perderán su número de teléfono
* Todas las **campañas** que usen este número lo perderán de su rotación de números de teléfono
* El **historial de llamadas** se conserva y sigue siendo accesible

<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>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>