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

# Descripción general de API v1

> Usa la API REST de levios v1 para gestionar automatizaciones de Instagram, contactos, etiquetas y métricas de cuenta con una clave y JSON.

API v1 expone endpoints JSON en esta ruta base:

```text theme={null}
https://levios.app/api/v1
```

Usa la API para:

* Listar las cuentas de Instagram disponibles para tu clave de API.
* Listar las publicaciones y las historias de una cuenta para vincular un
  disparador a una publicación.
* Crear, configurar, leer, activar, pausar y eliminar automatizaciones.
* Leer registros completos de contactos y filtrarlos por usuario de Instagram.
* Crear etiquetas de contacto y gestionar las etiquetas asignadas a un
  contacto.
* Leer métricas de cuentas y de una automatización.

## Conceptos básicos de las solicitudes

* Envía una clave de API de levios como credencial Bearer. API v1 rechaza los
  tokens de acceso OAuth y las sesiones del navegador.
* Envía JSON a los endpoints que aceptan un cuerpo.
* Lee `X-Correlation-ID` en cada respuesta cuando necesites rastrear una
  solicitud.
* Usa `expected_updated_at` cuando sea obligatorio para evitar sobrescribir un
  cambio más reciente de la automatización.
* Consulta la referencia del endpoint para ver todos los campos, enums, valores
  predeterminados y respuestas aceptados.

El [documento OpenAPI](/openapi/v1.json) procede de los esquemas que validan la
API activa. La `configuration` tipada y completa de la automatización, con cada
disparador, mensaje de apertura y acción de seguimiento, se define en ese
documento. Léelo directamente cuando necesites un campo, un enum o un límite
que la referencia del endpoint no detalla.

## Antes de integrar

* [Autenticación](/es/guides/authentication) explica las claves de API, los
  permisos y el acceso a las cuentas.
* [Paginación](/es/guides/pagination) explica `cursor`, `limit` y
  `next_cursor`.
* [Errores](/es/guides/errors) explica el formato JSON compartido.
* [Límites de solicitudes](/es/guides/rate-limits) explica `429` y
  `Retry-After`.

## Mensajes en carrusel

Consulta [Enviar mensajes en carrusel](/es/guides/carousels) para tarjetas con
imágenes, botones de enlace, una solicitud completa y un mensaje posterior
separado.

## Guías de creación

* [Creación y edición](/es/guides/automation-workflow)
* [Configuración](/es/guides/automation-configuration)
* [Triggers](/es/guides/automation-triggers)
* [Actions](/es/guides/automation-actions)
* [Creación mediante MCP](/es/mcp/automation-authoring)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.