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

# Desvincular dispositivo

> Desvincula o marca como robado un dispositivo y suspende su SIM

## Authorization

<ParamField header="Authorization" type="string" required default="Bearer ">
  API Key. Formato: `Bearer lbt_•••`
</ParamField>

## Path Parameters

<ParamField path="id" type="uuid" required>
  ID del dispositivo
</ParamField>

## Body

<ParamField body="permanently" type="boolean" required>
  * `false` = desvincular (estado `"unlink"`)
  * `true` = robado (estado `"stolen"`, genera nuevo ID)
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "permanently": false
  }
  ```
</RequestExample>

## Respuesta

<ResponseField name="message" type="string">
  Mensaje de confirmación
</ResponseField>

<ResponseField name="id" type="uuid">
  ID original del dispositivo
</ResponseField>

<ResponseField name="new_id" type="uuid">
  Nuevo ID (solo cuando `permanently = true`)
</ResponseField>

<ResponseExample>
  ```json 200 Desvincular theme={null}
  {
    "message": "Device deleted successfully",
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
  ```

  ```json 200 Robo theme={null}
  {
    "message": "Device deleted successfully",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "new_id": "770e8400-e29b-41d4-a716-446655440000"
  }
  ```
</ResponseExample>

## Comportamiento

* Suspende la SIM asociada al dispositivo
* Elimina el dispositivo de los grupos de la cuenta
* Si es permanente, reinicia la ubicación y conexión del dispositivo y genera un nuevo ID

<Warning>
  Esta acción suspende la SIM y elimina el dispositivo de todos los grupos.
</Warning>

## Errores

| Código | Descripción           |
| ------ | --------------------- |
| `404`  | Dispositivo no existe |