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

# Introducción

> Documentación de la API de Locate

## Información General

La API de Locate permite gestionar cuentas, usuarios, grupos, dispositivos, telemetría y métodos de pago.

## URL Base

```
https://api.locatebyteli.com
```

## Autenticación

Todos los endpoints requieren autenticación mediante API Key en la cabecera Bearer:

```bash theme={null}
Authorization: Bearer lbt_••••••••••••••••••••
```

<Note>
  Puedes generar tu API Key desde **Configuración** → **Desarrolladores** en la plataforma.
</Note>

## Control de Acceso

* **Por grupos:** Los grupos del usuario se cruzan con los grupos asignados al dispositivo
* **Por enlace compartido:** Si es un enlace de share, se filtran dispositivos por los IDs permitidos
* **Por cuenta:** Algunos endpoints validan que la cuenta del usuario coincida con el recurso

## Jerarquía de Cuentas

| Tipo         | Descripción                     | Permisos                                 |
| ------------ | ------------------------------- | ---------------------------------------- |
| **Root**     | Cuenta administradora principal | Puede crear cualquier tipo de cuenta     |
| **Partner**  | Distribuidor                    | Puede crear solo cuentas tipo `customer` |
| **Customer** | Cliente final                   | No puede crear subcuentas                |

## Códigos de Error HTTP

| Código | Significado                                              |
| ------ | -------------------------------------------------------- |
| `200`  | Operación exitosa                                        |
| `400`  | Parámetros inválidos o mal formateados                   |
| `401`  | No autorizado / Cuenta ya verificada                     |
| `403`  | Prohibido (ej: email duplicado, eliminar usuario propio) |
| `404`  | Recurso no encontrado                                    |
| `408`  | Timeout                                                  |
| `409`  | Conflicto (recurso ya existe)                            |
| `500`  | Error interno del servidor                               |
| `502`  | Error de servicio externo                                |
| `503`  | Servicio no disponible                                   |
| `504`  | Timeout en la consulta                                   |