> 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, Datasources und Ordnern direkt aus Ihren Workflows heraus.

## Überblick

Storyblok ist ein Headless CMS mit einem visuellen Editor, mit dem Teams strukturierte Inhalte für jeden digitalen Kanal erstellen und verwalten können. Durch die Verbindung von Storyblok mit AirOps können Sie die Erstellung, Veröffentlichung und Verwaltung von Inhalten in Ihren Storyblok-Spaces automatisieren.

## Authentifizierung

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

1. Navigieren Sie zu **Einstellungen > Integrationen**
2. Suchen Sie den Storyblok-Bereich und klicken Sie auf "Konfigurieren"
3. Geben Sie Ihre **Management-Token** — ein Personal Access Token, der in Ihrem Storyblok-Konto unter **Mein Konto > Persönliche Zugriffstoken**. Erforderlich für Schreibvorgänge
4. Geben Sie Ihre **Access Token** — ein Content Delivery API-Token, den Sie in Ihrem Space unter finden **Einstellungen > Zugriffstoken**. Wird zum Lesen von Stories verwendet
5. Geben Sie Ihre **Space-ID** — die numerische ID Ihres Storyblok-Spaces, zu finden unter **Einstellungen > Space**
6. Wählen Sie optional eine **Region** — die Region Ihres Storyblok-Spaces: `eu` (Standard), `us`, `ca`, oder `ap`

{% hint style="info" %}
Lesevorgänge (Story abrufen, Stories auflisten) verwenden das Content Delivery API-Token, während Schreibvorgänge (Erstellen, Aktualisieren, Löschen, Veröffentlichen) 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 über den vollständigen Slug oder die ID abrufen
* **Stories auflisten** -- mehrere Stories mit optionalen Filtern abrufen
* **Story aktualisieren** -- den Inhalt oder die Metadaten einer bestehenden Story ändern
* **Story veröffentlichen** -- eine Story öffentlich verfügbar machen
* **Story unveröffentlichen** -- eine veröffentlichte Story wieder in den Entwurfsstatus zurücksetzen
* **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

### Datasources

* **Datasources auflisten** -- alle Datasources im Space abrufen
* **Datasource-Einträge auflisten** -- Einträge für eine bestimmte Datasource abrufen

### Ordner

* **Ordner auflisten** -- alle Ordner im Space abrufen

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-d000412c8d08139155e0dda1c415e143dd2f3bdb%2Fstoryblok-01-actions.png?alt=media" alt="Storyblok Integration step with the Action dropdown listing Create Story, Get Story, List Stories, Update Story, Publish Story, Unpublish Story, Delete Story, Get Component, List Components, List Datasources, List Datasource Entries, List Folders"><figcaption><p>Wählen Sie eine Storyblok-Aktion.</p></figcaption></figure>

## 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. `mein-blogbeitrag`)
3. **Inhalt** -- ein JSON-Objekt mit Inhaltsfeldern, die dem Komponentenschema der Story entsprechen (z. B. `{"component": "article", "title": "Hallo"}`)
4. **Übergeordnete ID** -- die numerische ID des übergeordneten Ordners, in dem die Story abgelegt werden soll

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-89f653187dd7e4bd09913ed3436f9b6008866ff6%2Fstoryblok-02-create-story.png?alt=media" alt="Storyblok Create Story action with name, slug, content JSON, and parent folder"><figcaption><p>Erstellen Sie eine Storyblok-Story aus Workflow-Ausgaben.</p></figcaption></figure>

### Story abrufen

1. **Vollständiger Slug oder ID** (erforderlich) -- der vollständige Slug (z. B. `blog/mein-beitrag`) 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, um Stories nach Name, Slug oder Inhalt zu filtern
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, die dem Komponentenschema der Story entsprechen
5. **Übergeordnete ID** -- die numerische ID des übergeordneten Ordners

### Story veröffentlichen

1. **Story-ID** (erforderlich) -- die numerische ID der zu veröffentlichenden Story

### Story unveröffentlichen

1. **Story-ID** (erforderlich) -- die numerische ID der unveröffentlichten 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.

### Datasources auflisten

1. **Pro Seite** -- die Anzahl der Datasources pro Seite (Standard: `25`, max: `100`)
2. **Seite** -- die Seitennummer für die Paginierung (Standard: `1`)

### Datasource-Einträge auflisten

1. **Datasource-ID** (erforderlich) -- die numerische ID der Datasource
2. **Pro Seite** -- die 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

* Automatisches Erstellen und Veröffentlichen von Blog-Stories aus KI-generierten Inhalten
* Aktualisieren von Story-Inhalten in großen Mengen basierend auf Workflow-Bedingungen
* Abrufen von Stories über den Slug, um bestehende Inhalte zu ergänzen oder neu zu schreiben
* Erstellen von Content-Pipelines, die Stories im Entwurf anlegen und nach der Überprüfung veröffentlichen
* Auflisten von Stories nach Tag oder Slug-Präfix, um Audits durchzuführen oder Massenänderungen anzuwenden
* Abrufen von Komponentenschemata, um strukturierte Inhalte programmgesteuert zu validieren oder zu erzeugen

{% hint style="info" %}
Hinweis: Die Storyblok-Integration erfordert sowohl ein Management-Token als auch ein Content Delivery API-Token. Stellen Sie sicher, dass beide Tokens über die entsprechenden Berechtigungen für die von Ihren Workflows ausgeführten Vorgänge verfügen.
{% 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=<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.
