> 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/de/integrationen/overview/integrations/builder-io.md).

# Builder.io

Integrieren Sie Ihren Workflow mit Builder.io

Der Builder.io-Integrationsschritt ermöglicht es Ihnen, Ihre AirOps-Workflows mit Ihren Builder.io-Bereichen zu verbinden. Diese native Integration bietet umfassende Funktionen zur Inhaltserstellung und Modellverwaltung direkt aus Ihren Workflows.

## Überblick

Builder.io ist ein visuelles Headless-CMS und ein Page-Builder, mit dem Teams strukturierten Content für jeden digitalen Kanal erstellen und verwalten können. Durch die Verbindung von Builder.io mit AirOps können Sie die Inhaltserstellung, Veröffentlichung und Modellverwaltung über Ihre Builder.io-Bereiche hinweg automatisieren.

## Authentifizierung

Bevor Sie die Builder.io-Integration in Ihren Workflows verwenden, müssen Sie zunächst Ihr Builder.io-Konto in den AirOps-Einstellungen verbinden:

1. Navigieren Sie zu **Einstellungen > Integrationen**
2. Suchen Sie den Builder.io-Bereich und klicken Sie auf „Konfigurieren“
3. Geben Sie Ihre **Privater API-Schlüssel** — zu finden in Ihrem Builder.io-Bereich unter **Kontoeinstellungen > Bereich**. Erforderlich für alle Schreiboperationen und zum Lesen unveröffentlichter Inhalte
4. Optional geben Sie Ihren **Öffentlichen API-Schlüssel** — wird zum Lesen veröffentlichter Inhalts-Einträge ohne Authentifizierung verwendet

{% hint style="info" %}
Der private API-Schlüssel ist zum Erstellen, Aktualisieren und Löschen von Inhalten und Modellen erforderlich. Der öffentliche API-Schlüssel wird nur benötigt, wenn Ihre Workflows öffentlich zugängliche Inhalte lesen.
{% endhint %}

## Verfügbare Aktionen

### Inhaltsverwaltung

* **Inhalt erstellen** -- einen neuen Inhaltseintrag zu einem Builder.io-Modell hinzufügen
* **Inhalt abrufen** -- einen einzelnen Inhaltseintrag anhand der ID abrufen
* **Inhalte auflisten** -- mehrere Inhaltseinträge aus einem Modell mit optionalen Filtern abrufen
* **Inhalt aktualisieren** -- die Felder oder den Status eines vorhandenen Inhaltseintrags ändern
* **Inhalt löschen** -- einen Inhaltseintrag dauerhaft entfernen

### Modellverwaltung

* **Modell erstellen** -- ein neues Content-Modell in Ihrem Builder.io-Bereich definieren
* **Modell abrufen** -- ein einzelnes Modell anhand der ID oder des Namens abrufen
* **Modelle auflisten** -- alle Modelle in Ihrem Bereich abrufen
* **Modell aktualisieren** -- die Konfiguration oder Felder eines vorhandenen Modells ändern

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-00cae0b01651149d76eac35cbd242cd76b220cdf%2Fbuilder-io-01-actions.png?alt=media" alt="Builder.io Integration step with the Action dropdown listing Create Content, Get Content, List Content, Update Content, Delete Content, Create Model, Get Model, List Models, Update Model"><figcaption><p>Wählen Sie eine Builder.io-Aktion.</p></figcaption></figure>

## Aktionsparameter

### Inhalt erstellen

1. **Modellname** (erforderlich) -- der API-Name des Builder.io-Modells, in dem der Eintrag erstellt werden soll (z. B. `blog-post`)
2. **Name** (erforderlich) -- der menschenlesbare Titel des Inhaltseintrags
3. **Daten** -- ein JSON-Objekt mit benutzerdefinierten Feldwerten (z. B. `{"title": "Hello", "body": "..."}`)
4. **Veröffentlicht** -- der Veröffentlichungsstatus des Eintrags: `Entwurf`, `veröffentlicht`, oder `archiviert`

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-d1e1107393110c69ecf9f42b2397b9156b852268%2Fbuilder-io-02-create-content.png?alt=media" alt="Builder.io Create Content action with a model name, entry name, JSON data, and draft status"><figcaption><p>Erstellen Sie aus Workflow-Ausgaben einen Builder.io-Entwurfseintrag.</p></figcaption></figure>

### Inhalt abrufen

1. **Modellname** (erforderlich) -- der API-Name des Builder.io-Modells
2. **Eintrags-ID** (erforderlich) -- die ID des abzurufenden Inhaltseintrags

### Inhalte auflisten

1. **Modellname** (erforderlich) -- der API-Name des Builder.io-Modells
2. **Unveröffentlichte einschließen** -- ob Entwürfe eingeschlossen werden sollen: `wahr` oder `falsch` (Standard: `falsch`)
3. **Felder** -- durch Kommas getrennte Feldpfade, die in die Antwort aufgenommen werden sollen (z. B. `id,name,data.title`)
4. **Ausschließen** -- durch Kommas getrennte Feldpfade, die aus der Antwort ausgeschlossen werden sollen (z. B. `data.blocks`)
5. **Sortieren** -- ein JSON-Objekt, das Sortierfelder und die Richtung angibt, wobei `1` steigend ist und `-1` absteigend ist (z. B. `{"data.publishedDate": -1}`)
6. **Limit** -- die Anzahl der Einträge pro Seite (Standard: `30`, max: `100`)
7. **Offset** -- die Anzahl der für die Paginierung zu überspringenden Einträge (Standard: `0`)

### Inhalt aktualisieren

1. **Modellname** (erforderlich) -- der API-Name des Builder.io-Modells
2. **Eintrags-ID** (erforderlich) -- die ID des zu aktualisierenden Inhaltseintrags
3. **Name** -- der neue menschenlesbare Titel für den Eintrag
4. **Daten** -- ein JSON-Objekt mit zu aktualisierenden Feldern. Nur die angegebenen Felder werden geändert
5. **Veröffentlicht** -- der neue Veröffentlichungsstatus: `Entwurf`, `veröffentlicht`, oder `archiviert`

### Inhalt löschen

1. **Modellname** (erforderlich) -- der API-Name des Builder.io-Modells
2. **Eintrags-ID** (erforderlich) -- die ID des zu löschenden Inhaltseintrags. Diese Aktion kann nicht rückgängig gemacht werden

### Modell erstellen

1. **Name** (erforderlich) -- der API-Name des neuen Modells im kebab-case (z. B. `blog-post`)
2. **Art** (erforderlich) -- der Typ des Modells: `Daten`, `Seite`, `Komponente`, `Bereich`, oder `Symbol`
3. **Hilfetext** -- eine Beschreibung des Modells, die in der Builder.io-Benutzeroberfläche angezeigt wird
4. **Einzelinstanz** -- ob nur ein Eintrag für dieses Modell existieren kann: `wahr` oder `falsch`
5. **Wiederholbar** -- ob mehrere Einträge erlaubt sind: `wahr` oder `falsch`
6. **Öffentlich lesbar** -- ob Einträge ohne Authentifizierung gelesen werden können: `wahr` oder `falsch`
7. **Öffentlich schreibbar** -- ob Einträge ohne Authentifizierung geschrieben werden können: `wahr` oder `falsch`
8. **Felder** -- ein JSON-Array von Felddefinitionen, jeweils mit einem `name` und `Typ` (z. B. `[{"name": "title", "type": "string"}]`)

### Modell abrufen

1. **Suchen nach** -- wie das Modell identifiziert werden soll: `id` (Standard) oder `name`
2. **Suchwert** (erforderlich) -- die Modell-ID oder der Modellname, nach dem gesucht werden soll

### Modelle auflisten

1. **Limit** -- die Anzahl der Modelle pro Seite (Standard: `100`)
2. **Offset** -- die Anzahl der für die Paginierung zu überspringenden Modelle (Standard: `0`)

### Modell aktualisieren

1. **Modell-ID** (erforderlich) -- die ID des zu aktualisierenden Modells
2. **Name** -- der neue API-Name im kebab-case
3. **Art** -- der neue Modelltyp: `Daten`, `Seite`, `Komponente`, `Bereich`, oder `Symbol`
4. **Hilfetext** -- die neue Beschreibung für das Modell
5. **Einzelinstanz** -- die Einzelinstanz-Einstellung aktualisieren: `wahr` oder `falsch`
6. **Wiederholbar** -- die Wiederholbar-Einstellung aktualisieren: `wahr` oder `falsch`
7. **Öffentlich lesbar** -- die öffentlich-lesbar-Einstellung aktualisieren: `wahr` oder `falsch`
8. **Öffentlich schreibbar** -- die öffentlich-schreibbar-Einstellung aktualisieren: `wahr` oder `falsch`
9. **Archiviert** -- setzen auf `wahr` um das Modell zu archivieren
10. **Felder** -- ein JSON-Array von Felddefinitionen, das die vorhandenen Felder des Modells ersetzt

## Häufige Anwendungsfälle

* Inhalte automatisch aus KI-generierten Texten erstellen und veröffentlichen
* Inhaltseintragsstatus basierend auf Workflow-Bedingungen in großen Mengen aktualisieren
* Einträge nach Modell abrufen, um vorhandene Inhalte anzureichern oder neu zu schreiben
* Erstellen von Content-Pipelines, die Einträge als Entwurf anlegen und nach der Prüfung veröffentlichen
* Neue Builder.io-Modelle programmgesteuert als Teil eines Website-Einrichtungs-Workflows erstellen
* Einträge über ein Modell hinweg auflisten, um Prüfungen durchzuführen oder Massenumwandlungen anzuwenden

{% hint style="info" %}
Hinweis: Die Builder.io-Integration erfordert einen Private API Key mit Zugriff auf den Zielbereich. Stellen Sie sicher, dass Ihr Schlüssel über die erforderlichen Berechtigungen für die von Ihren Workflows ausgeführten Operationen verfügt.
{% 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/de/integrationen/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.
