> 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 Verwaltung von Inhaltseinträgen und Modellen direkt aus Ihren Workflows. ## Überblick Builder.io ist ein visuelles Headless-CMS und Seitenersteller, mit dem Teams strukturierte Inhalte für jeden digitalen Kanal erstellen und verwalten können. Durch die Verbindung von Builder.io mit AirOps können Sie die Erstellung, Veröffentlichung und Modellverwaltung von Inhalten in Ihren Builder.io-Bereichen 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 Ihren **Private API-Schlüssel** — zu finden in Ihrem Builder.io-Bereich unter **Kontoeinstellungen > Bereich**. Erforderlich für alle Schreibvorgänge und zum Lesen unveröffentlichter Inhalte 4. Geben Sie optional Ihren **Public API-Schlüssel** — wird zum Lesen veröffentlichter Inhaltseinträge ohne Authentifizierung verwendet {% hint style="info" %} Der Private API-Schlüssel wird zum Erstellen, Aktualisieren und Löschen von Inhalten und Modellen benötigt. Der Public API-Schlüssel wird nur benötigt, wenn Ihre Workflows öffentlich zugängliche Inhalte lesen. {% endhint %} ## Verfügbare Aktionen ### Inhaltsverwaltung * **Inhalt erstellen** -- fügt einen neuen Inhaltseintrag zu einem Builder.io-Modell hinzu * **Inhalt abrufen** -- einen einzelnen Inhaltseintrag anhand der ID abrufen * **Inhalte auflisten** -- mehrere Inhaltseinträge aus einem Modell mit optionalen Filtern abrufen * **Inhalt aktualisieren** -- einen vorhandenen Inhaltseintrag ändern: Felder oder Status * **Inhalt löschen** -- einen Inhaltseintrag dauerhaft entfernen ### Modellverwaltung * **Modell erstellen** -- ein neues Inhaltsmodell in Ihrem Builder.io-Bereich definieren * **Modell abrufen** -- ein einzelnes Modell anhand von ID oder Name abrufen * **Modelle auflisten** -- alle Modelle in Ihrem Bereich abrufen * **Modell aktualisieren** -- die Konfiguration oder Felder eines vorhandenen Modells ändern ## 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 `archived` ### 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 einbeziehen** -- ob Entwurfs-Einträge einbezogen werden sollen: `true` oder `false` (Standard: `false`) 3. **Felder** -- durch Kommas getrennte Feldpfade, die in die Antwort aufgenommen werden sollen (z. B. `id,name,data.title`) 4. **Auslassen** -- durch Kommas getrennte Feldpfade, die aus der Antwort ausgeschlossen werden sollen (z. B. `data.blocks`) 5. **Sortieren** -- ein JSON-Objekt, das Sortierfelder und -richtung angibt, wobei `1` aufsteigend ist und `-1` absteigend ist (z. B. `{"data.publishedDate": -1}`) 6. **Limit** -- Anzahl der Einträge pro Seite (Standard: `30`, max.: `100`) 7. **Versatz** -- 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 `archived` ### 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 in Kebab-Case (z. B. `blog-post`) 2. **Art** (erforderlich) -- der Modelltyp: `Daten`, `page`, `Komponente`, `Bereich`, oder `Symbol` 3. **Hilfetext** -- eine Beschreibung des Modells, die in der Builder.io-Benutzeroberfläche angezeigt wird 4. **Singleton** -- ob nur ein Eintrag für dieses Modell existieren kann: `true` oder `false` 5. **Wiederholbar** -- ob mehrere Einträge erlaubt sind: `true` oder `false` 6. **Öffentlich lesbar** -- ob Einträge ohne Authentifizierung gelesen werden können: `true` oder `false` 7. **Öffentlich schreibbar** -- ob Einträge ohne Authentifizierung geschrieben werden können: `true` oder `false` 8. **Felder** -- ein JSON-Array mit Felddefinitionen, jeweils mit einem `Name` und `Typ` (z. B. `[{"name": "title", "type": "string"}]`) ### Modell abrufen 1. **Suche nach** -- wie das Modell identifiziert wird: `id` (Standard) oder `Name` 2. **Suchwert** (erforderlich) -- die Modell-ID oder der Modellname, nach dem gesucht werden soll ### Modelle auflisten 1. **Limit** -- Anzahl der Modelle pro Seite (Standard: `100`) 2. **Versatz** -- 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`, `page`, `Komponente`, `Bereich`, oder `Symbol` 4. **Hilfetext** -- die neue Beschreibung für das Modell 5. **Singleton** -- die Singleton-Einstellung aktualisieren: `true` oder `false` 6. **Wiederholbar** -- die wiederholbare Einstellung aktualisieren: `true` oder `false` 7. **Öffentlich lesbar** -- die Einstellung für öffentliches Lesen aktualisieren: `true` oder `false` 8. **Öffentlich schreibbar** -- die Einstellung für öffentliches Schreiben aktualisieren: `true` oder `false` 9. **Archiviert** -- setzen auf `true` um das Modell zu archivieren 10. **Felder** -- ein JSON-Array mit Felddefinitionen zum Ersetzen der vorhandenen Felder des Modells ## Häufige Anwendungsfälle * Automatisches Erstellen und Veröffentlichen von Inhaltseinträgen aus KI-generierten Texten * Status von Inhaltseinträgen in großen Mengen basierend auf Workflow-Bedingungen aktualisieren * Einträge nach Modell abrufen, um vorhandene Inhalte anzureichern oder umzuschreiben * Content-Pipelines aufbauen, die Einträge als Entwurf erstellen und nach der Prüfung veröffentlichen * Neue Builder.io-Modelle programmgesteuert im Rahmen 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-Schlüssel mit Zugriff auf den Zielbereich. Stellen Sie sicher, dass Ihr Schlüssel über die erforderlichen Berechtigungen für die von Ihren Workflows ausgeführten Vorgänge 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=&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.