> 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/storyblok.md). # Storyblok Integrieren Sie Ihren Workflow mit Storyblok Der Storyblok-Integrationsschritt ermöglicht es Ihnen, Ihre AirOps-Workflows mit Ihren Storyblok-Spaces zu verbinden. Diese native Integration bietet umfassende Funktionen zur Verwaltung von Stories, Komponenten, Datenquellen und Ordnern direkt aus Ihren Workflows. ## Überblick Storyblok ist ein Headless-CMS mit einem visuellen Editor, der Teams ermöglicht, strukturierte Inhalte für jeden digitalen Kanal zu erstellen und zu verwalten. Durch die Verbindung von Storyblok mit AirOps können Sie die Inhaltserstellung, Veröffentlichung und Verwaltung über Ihre Storyblok-Spaces hinweg automatisieren. ## Authentifizierung Bevor Sie die Storyblok-Integration in Ihren Workflows verwenden, müssen Sie zuerst Ihr Storyblok-Konto in den AirOps-Einstellungen verbinden: 1. Navigieren Sie zu **Einstellungen > Integrationen** 2. Finden Sie den Storyblok-Bereich und klicken Sie auf „Konfigurieren“ 3. Geben Sie Ihren **Management Token** — ein Personal Access Token, der in Ihrem Storyblok-Konto unter **My Account > Personal Access Tokens**. Erforderlich für Schreiboperationen 4. Geben Sie Ihren **Zugriffstoken** — ein Content Delivery API-Token, den Sie in Ihrem Space unter **Settings > Access Tokens**. Wird zum Lesen von Stories verwendet 5. Geben Sie Ihren **Space ID** — die numerische ID Ihres Storyblok-Spaces, zu finden unter **Settings > Space** 6. Wählen Sie optional einen **Region** — die Region Ihres Storyblok-Spaces: `eu` (Standard), `us`, `ca`, oder `ap` {% hint style="info" %} Leseoperationen (Get Story, List Stories) verwenden das Content Delivery API-Token, während Schreiboperationen (Create, Update, Delete, Publish) das Management Token erfordern. {% endhint %} ## Verfügbare Aktionen ### Story-Verwaltung * **Story erstellen** -- eine neue Story zu einem Storyblok-Space hinzufügen * **Story abrufen** -- eine einzelne Story anhand des vollständigen Slugs oder der ID abrufen * **Stories auflisten** -- mehrere Stories mit optionalen Filtern abrufen * **Story aktualisieren** -- den Inhalt oder die Metadaten einer vorhandenen Story ändern * **Story veröffentlichen** -- eine Story öffentlich verfügbar machen * **Story zurückziehen** -- eine veröffentlichte Story wieder in einen Entwurf zurückversetzen * **Story löschen** -- eine Story dauerhaft entfernen ### Komponenten * **Komponente abrufen** -- eine einzelne Komponente anhand der ID abrufen * **Komponenten auflisten** -- alle im Space definierten Komponenten abrufen ### Datenquellen * **Datenquellen auflisten** -- alle Datenquellen im Space abrufen * **Datenquellen-Einträge auflisten** -- Einträge für eine bestimmte Datenquelle abrufen ### Ordner * **Ordner auflisten** -- alle Ordner im Space abrufen ## Aktionsparameter ### Story erstellen 1. **Name** (erforderlich) -- der Anzeigename der Story (z. B. `Mein Blogbeitrag`) 2. **Slug** (erforderlich) -- der URL-Slug für die Story (z. B. `my-blog-post`) 3. **Inhalt** -- ein JSON-Objekt mit Inhaltsfeldern, das dem Komponentenschema der Story entspricht (z. B. `{"component": "article", "title": "Hallo"}`) 4. **Eltern-ID** -- die numerische ID des übergeordneten Ordners, in dem die Story platziert werden soll ### Story abrufen 1. **Vollständiger Slug oder ID** (erforderlich) -- der vollständige Slug (z. B. `blog/my-post`) oder die numerische ID der abzurufenden Story 2. **Version** -- welche Version zurückgegeben werden soll: `veröffentlicht` (Standard) oder `Entwurf` ### Stories auflisten 1. **Beginnt mit** -- Stories filtern, deren vollständiger Slug mit einem bestimmten String beginnt (z. B. `blog/`) 2. **Version** -- welche Version zurückgegeben werden soll: `veröffentlicht` (Standard) oder `Entwurf` 3. **Suchbegriff** -- eine Suchanfrage zum Filtern von Stories nach Name, Slug oder Inhalt 4. **Mit Tag** -- Stories filtern, die einen bestimmten Tag-Slug haben 5. **Sortieren nach** -- Feld und Richtung zum Sortieren der Ergebnisse (z. B. `name:asc`, `created_at:desc`) 6. **Pro Seite** -- die Anzahl der Stories pro Seite (Standard: `25`, max.: `100`) 7. **Seite** -- die Seitennummer für die Paginierung (Standard: `1`) ### Story aktualisieren 1. **Story-ID** (erforderlich) -- die numerische ID der zu aktualisierenden Story 2. **Name** -- der Anzeigename der Story 3. **Slug** -- der URL-Slug für die Story 4. **Inhalt** -- ein JSON-Objekt mit Inhaltsfeldern, das dem Komponentenschema der Story entspricht 5. **Eltern-ID** -- die numerische ID des übergeordneten Ordners ### Story veröffentlichen 1. **Story-ID** (erforderlich) -- die numerische ID der zu veröffentlichenden Story ### Story zurückziehen 1. **Story-ID** (erforderlich) -- die numerische ID der zurückzuziehenden Story ### Story löschen 1. **Story-ID** (erforderlich) -- die numerische ID der zu löschenden Story ### Komponente abrufen 1. **Komponenten-ID** (erforderlich) -- die numerische ID der abzurufenden Komponente ### Komponenten auflisten Keine Parameter erforderlich. ### Datenquellen auflisten 1. **Pro Seite** -- die Anzahl der Datenquellen pro Seite (Standard: `25`, max.: `100`) 2. **Seite** -- die Seitennummer für die Paginierung (Standard: `1`) ### Datenquellen-Einträge auflisten 1. **Datenquellen-ID** (erforderlich) -- die numerische ID der Datenquelle 2. **Pro Seite** -- Anzahl der Einträge pro Seite (Standard: `25`, max.: `100`) 3. **Seite** -- die Seitennummer für die Paginierung (Standard: `1`) ### Ordner auflisten 1. **Pro Seite** -- die Anzahl der Ordner pro Seite (Standard: `25`, max.: `100`) 2. **Seite** -- die Seitennummer für die Paginierung (Standard: `1`) ## Häufige Anwendungsfälle * Automatisch Stories aus KI-generierten Inhalten erstellen und veröffentlichen * Story-Inhalte basierend auf Workflow-Bedingungen massenhaft aktualisieren * Stories per Slug abrufen, um vorhandene Inhalte anzureichern oder umzuschreiben * Inhaltspipelines aufbauen, die Stories als Entwurf erstellen und nach der Überprüfung veröffentlichen * Stories nach Tag oder Slug-Präfix auflisten, um Audits durchzuführen oder Massenänderungen anzuwenden * Komponentenschemata abrufen, um strukturierte Inhalte programmgesteuert zu validieren oder zu generieren {% hint style="info" %} Hinweis: Für die Storyblok-Integration sind sowohl ein Management Token als auch ein Content Delivery API-Token erforderlich. Stellen Sie sicher, dass beide Tokens die erforderlichen Berechtigungen für die von Ihren Workflows ausgeführten Operationen haben. {% 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/storyblok.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.