> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/integraciones/overview/integrations/builder-io.md).

# Builder.io

Integra tu flujo de trabajo con Builder.io

El paso de integración de Builder.io te permite conectar tus flujos de trabajo de AirOps con tus espacios de Builder.io. Esta integración nativa proporciona capacidades completas de gestión de entradas de contenido y de modelos directamente desde tus flujos de trabajo.

## Descripción general

Builder.io es un CMS headless visual y un creador de páginas que permite a los equipos crear y gestionar contenido estructurado para cualquier canal digital. Al conectar Builder.io con AirOps, puedes automatizar la creación de contenido, la publicación y la gestión de modelos en tus espacios de Builder.io.

## Autenticación

Antes de usar la integración de Builder.io en tus flujos de trabajo, primero debes conectar tu cuenta de Builder.io en la configuración de AirOps:

1. Navega a **Ajustes > Integraciones**
2. Busca la sección de Builder.io y haz clic en "Configurar"
3. Introduce tu **Clave de API privada** — se encuentra en tu espacio de Builder.io en **Configuración de la cuenta > Espacio**. Requerida para todas las operaciones de escritura y la lectura de contenido no publicado
4. Opcionalmente, introduce tu **Clave de API pública** — se usa para leer entradas de contenido publicadas sin autenticación

{% hint style="info" %}
La clave de API privada es necesaria para crear, actualizar y eliminar contenido y modelos. La clave de API pública solo se necesita si tus flujos de trabajo leen contenido accesible públicamente.
{% endhint %}

## Acciones disponibles

### Gestión de contenido

* **Crear contenido** -- añade una nueva entrada de contenido a un modelo de Builder.io
* **Obtener contenido** -- recupera una sola entrada de contenido por ID
* **Listar contenido** -- obtiene varias entradas de contenido de un modelo con filtros opcionales
* **Actualizar contenido** -- modifica los campos o el estado de una entrada de contenido existente
* **Eliminar contenido** -- elimina permanentemente una entrada de contenido

### Gestión de modelos

* **Crear modelo** -- define un nuevo modelo de contenido en tu espacio de Builder.io
* **Obtener modelo** -- recupera un solo modelo por ID o nombre
* **Listar modelos** -- obtiene todos los modelos en tu espacio
* **Actualizar modelo** -- modifica la configuración o los campos de un modelo existente

## Parámetros de acción

### Crear contenido

1. **Nombre del modelo** (obligatorio) -- el nombre de API del modelo de Builder.io en el que crear la entrada (p. ej., `blog-post`)
2. **Nombre** (obligatorio) -- el título legible por humanos de la entrada de contenido
3. **Datos** -- un objeto JSON de valores de campos personalizados (p. ej., `{"title": "Hola", "body": "..."}`)
4. **Publicado** -- el estado de publicación de la entrada: `borrador`, `published`, o `archivado`

### Obtener contenido

1. **Nombre del modelo** (obligatorio) -- el nombre de API del modelo de Builder.io
2. **ID de la entrada** (obligatorio) -- el ID de la entrada de contenido que se va a recuperar

### Listar contenido

1. **Nombre del modelo** (obligatorio) -- el nombre de API del modelo de Builder.io
2. **Incluir no publicado** -- si incluir entradas en borrador: `true` o `false` (predeterminado: `false`)
3. **Campos** -- rutas de campos separadas por comas para incluir en la respuesta (p. ej., `id,name,data.title`)
4. **Omitir** -- rutas de campos separadas por comas para excluir de la respuesta (p. ej., `data.blocks`)
5. **Ordenar** -- un objeto JSON que especifica los campos de ordenación y la dirección, donde `1` es ascendente y `-1` es descendente (p. ej., `{"data.publishedDate": -1}`)
6. **Límite** -- el número de entradas por página (predeterminado: `30`, máximo: `100`)
7. **Desplazamiento** -- el número de entradas que se omiten para la paginación (predeterminado: `0`)

### Actualizar contenido

1. **Nombre del modelo** (obligatorio) -- el nombre de API del modelo de Builder.io
2. **ID de la entrada** (obligatorio) -- el ID de la entrada de contenido que se va a actualizar
3. **Nombre** -- el nuevo título legible por humanos para la entrada
4. **Datos** -- un objeto JSON de campos que se van a actualizar. Solo se modifican los campos especificados
5. **Publicado** -- el nuevo estado de publicación: `borrador`, `published`, o `archivado`

### Eliminar contenido

1. **Nombre del modelo** (obligatorio) -- el nombre de API del modelo de Builder.io
2. **ID de la entrada** (obligatorio) -- el ID de la entrada de contenido que se va a eliminar. Esta acción no se puede deshacer

### Crear modelo

1. **Nombre** (obligatorio) -- el nombre de API del nuevo modelo en kebab-case (p. ej., `blog-post`)
2. **Tipo** (obligatorio) -- el tipo de modelo: `datos`, `página`, `componente`, `sección`, o `símbolo`
3. **Texto de ayuda** -- una descripción del modelo que se muestra en la interfaz de Builder.io
4. **Único** -- si solo puede existir una entrada para este modelo: `true` o `false`
5. **Repetible** -- si se permiten varias entradas: `true` o `false`
6. **Legible públicamente** -- si las entradas se pueden leer sin autenticación: `true` o `false`
7. **Escribible públicamente** -- si las entradas se pueden escribir sin autenticación: `true` o `false`
8. **Campos** -- un arreglo JSON de definiciones de campos, cada una con un `nombre` y `tipo` (p. ej. `[{"name": "title", "type": "string"}]`)

### Obtener modelo

1. **Buscar por** -- cómo identificar el modelo: `id` (predeterminado) o `nombre`
2. **Valor de búsqueda** (obligatorio) -- el ID o nombre del modelo que se va a buscar

### Listar modelos

1. **Límite** -- el número de modelos por página (predeterminado: `100`)
2. **Desplazamiento** -- el número de modelos que se omiten para la paginación (predeterminado: `0`)

### Actualizar modelo

1. **ID del modelo** (obligatorio) -- el ID del modelo que se va a actualizar
2. **Nombre** -- el nuevo nombre de API en kebab-case
3. **Tipo** -- el nuevo tipo de modelo: `datos`, `página`, `componente`, `sección`, o `símbolo`
4. **Texto de ayuda** -- la nueva descripción del modelo
5. **Único** -- actualiza la configuración de único: `true` o `false`
6. **Repetible** -- actualiza la configuración de repetible: `true` o `false`
7. **Legible públicamente** -- actualiza la configuración de lectura pública: `true` o `false`
8. **Escribible públicamente** -- actualiza la configuración de escritura pública: `true` o `false`
9. **Archivada** -- establece en `true` para archivar el modelo
10. **Campos** -- un arreglo JSON de definiciones de campos para reemplazar los campos existentes del modelo

## Casos de uso comunes

* Creación y publicación automáticas de entradas de contenido a partir de texto generado por IA
* Actualización masiva de estados de entradas de contenido en función de las condiciones del flujo de trabajo
* Obtención de entradas por modelo para enriquecer o reescribir contenido existente
* Crear canalizaciones de contenido que generen entradas en borrador y las publiquen después de la revisión
* Creación programática de nuevos modelos de Builder.io como parte de un flujo de trabajo de configuración del sitio
* Listado de entradas en un modelo para realizar auditorías o aplicar transformaciones masivas

{% hint style="info" %}
Nota: la integración de Builder.io requiere una Clave de API privada con acceso al espacio de destino. Asegúrate de que tu clave tenga los permisos necesarios para las operaciones que realizan tus flujos de trabajo.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/integraciones/overview/integrations/builder-io.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.