> 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/craft-cms.md).

# Craft CMS

Integrieren Sie Ihren Workflow mit Craft CMS

Der Schritt zur Craft-CMS-Integration ermöglicht es Ihnen, Ihre AirOps-Workflows mit Ihrer Craft-CMS-Instanz zu verbinden. Diese native Integration bietet umfassende Funktionen zur Verwaltung von Einträgen und Assets direkt aus Ihren Workflows heraus.

## Überblick

Craft CMS ist ein flexibles, benutzerfreundliches Content-Management-System, das für die Erstellung individueller digitaler Erlebnisse entwickelt wurde. Durch die Verbindung von Craft CMS mit AirOps können Sie die Erstellung von Inhalten, das Veröffentlichen und die Asset-Verwaltung über Ihre Craft-Projekte hinweg automatisieren.

## Authentifizierung

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

1. Navigieren Sie zu **Einstellungen > Integrationen**
2. Suchen Sie den Bereich für Craft CMS und klicken Sie auf „Configure“
3. Geben Sie Ihre **GraphQL-Token** — ein Token mit Schreibberechtigungen, das in Ihrem Craft-CMS-Kontrollbereich unter **GraphQL > Tokens**
4. Geben Sie Ihre **Site-URL** — die Basis-URL Ihrer Craft-CMS-Instanz (z. B. `https://example.com`)
5. Optional einen **Standard-Autor-ID** — die numerische ID des Craft-CMS-Benutzers, der standardmäßig als Autor von Einträgen zugewiesen wird. Einzelne Aktionen können diesen Wert überschreiben

{% hint style="info" %}
Ihr GraphQL-Token muss über Berechtigungen zum Lesen und Schreiben von Einträgen und Assets in den Bereichen verfügen, die Sie verwenden möchten.
{% endhint %}

## Verfügbare Aktionen

### Eintragsverwaltung

* **Eintrag erstellen** -- einen neuen Eintrag zu einer Craft-CMS-Sektion hinzufügen
* **Eintrag aktualisieren** -- die Felder, den Status oder die Metadaten eines vorhandenen Eintrags ändern
* **Eintrag abrufen** -- einen einzelnen Eintrag anhand von ID oder Slug abrufen
* **Einträge auflisten** -- mehrere Einträge aus einer Sektion mit optionalen Filtern abrufen
* **Eintrag löschen** -- einen Eintrag dauerhaft entfernen

### Asset-Verwaltung

* **Asset abrufen** -- ein einzelnes Asset anhand der ID abrufen
* **Assets auflisten** -- Assets aus einem Volume mit optionalen Filtern abrufen
* **Asset an Eintrag anhängen** -- vorhandene Assets mit einem Asset-Feld eines Eintrags verknüpfen
* **Asset löschen** -- ein Asset dauerhaft aus einem Volume entfernen

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-bb42b640dca84f5966c32335d30eba5ea932bd8d%2Fcraft-cms-01-actions.png?alt=media" alt="Craft CMS Integration step with the Action dropdown listing Create Entry, Update Entry, Get Entry, List Entries, Delete Entry, Get Asset, List Assets, Attach Asset to Entry, Delete Asset"><figcaption><p>Wählen Sie eine Craft-CMS-Aktion.</p></figcaption></figure>

## Aktionsparameter

### Eintrag erstellen

1. **Abschnitt** (erforderlich) -- der Handle der Sektion, zu der der Eintrag gehört (z. B. `blog`, `news`)
2. **Eintragstyp** -- der Handle des Eintragstyps (z. B. `default`, `article`). Standardmäßig `default`
3. **Titel** -- der Eintragstitel
4. **Slug** -- der URL-Slug für den Eintrag
5. **Status** -- Eintragsstatus: `live` oder `deaktiviert`
6. **Veröffentlichungsdatum** -- das Datum, an dem der Eintrag veröffentlicht werden soll (ISO-8601-Format)
7. **Ablaufdatum** -- das Datum, an dem der Eintrag ablaufen soll (ISO-8601-Format)
8. **Benutzerdefinierte Felder** -- ein JSON-Objekt mit benutzerdefinierten Feldwerten, nach Feld-Handle indexiert
9. **Autor-ID** -- die numerische ID des Autors des Eintrags. Überschreibt die in den Anmeldedaten festgelegte Standard-Autor-ID

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-e53edbdf840569145aef2d402172a288ffcd58c9%2Fcraft-cms-02-create-entry.png?alt=media" alt="Craft CMS Create Entry action with section, entry type, title, slug, status, and custom fields"><figcaption><p>Erstellen Sie einen Craft-CMS-Eintrag aus den Workflow-Ausgaben.</p></figcaption></figure>

### Eintrag aktualisieren

1. **Eintrags-ID** (erforderlich) -- die numerische ID des zu aktualisierenden Eintrags
2. **Abschnitt** -- der Handle der Sektion, zu der der Eintrag gehört
3. **Eintragstyp** -- der Handle des Eintragstyps
4. **Titel** -- der Eintragstitel
5. **Slug** -- der URL-Slug für den Eintrag
6. **Status** -- Eintragsstatus: `live` oder `deaktiviert`
7. **Veröffentlichungsdatum** -- das Datum, an dem der Eintrag veröffentlicht werden soll
8. **Ablaufdatum** -- das Datum, an dem der Eintrag ablaufen soll
9. **Benutzerdefinierte Felder** -- ein JSON-Objekt mit benutzerdefinierten Feldwerten, nach Feld-Handle indexiert
10. **Autor-ID** -- die numerische ID des Autors des Eintrags. Überschreibt die in den Anmeldedaten festgelegte Standard-Autor-ID

### Eintrag abrufen

1. **Suchen nach** (erforderlich) -- wie der Eintrag identifiziert werden soll: `id` oder `slug`
2. **Suchwert** (erforderlich) -- die ID oder der Slug-Wert, nach dem gesucht werden soll
3. **Eintragstyp** -- der Handle des Eintragstyps, verwendet zum Erstellen benutzerdefinierter Feldfragmente
4. **Felder** -- kommagetrennte Liste von Handles benutzerdefinierter Felder, die in die Antwort aufgenommen werden sollen (z. B. `heroImage,body`)

### Einträge auflisten

1. **Abschnitt** -- der Sektionen-Handle zum Filtern
2. **Eintragstyp** -- der Handle des Eintragstyps, verwendet zum Erstellen benutzerdefinierter Feldfragmente
3. **Felder** -- kommagetrennte Liste von Handles benutzerdefinierter Felder, die in die Antwort aufgenommen werden sollen
4. **Suche** -- eine Suchabfrage zum Filtern von Einträgen
5. **Limit** -- die maximale Anzahl der zurückzugebenden Einträge
6. **Offset** -- die Anzahl der zu überspringenden Einträge (für die Paginierung)

### Eintrag löschen

1. **Eintrags-ID** (erforderlich) -- die numerische ID des zu löschenden Eintrags

### Asset abrufen

1. **Asset-ID** (erforderlich) -- die numerische ID des abzurufenden Assets

### Assets auflisten

1. **Volume** -- der Volume-Handle, nach dem Assets gefiltert werden (z. B. `Bilder`, `Dokumente`)
2. **Suche** -- eine Suchabfrage zum Filtern von Assets
3. **Limit** -- die maximale Anzahl der zurückzugebenden Assets

### Asset an Eintrag anhängen

1. **Eintrags-ID** (erforderlich) -- die numerische ID des Eintrags, dem Assets zugeordnet werden sollen
2. **Abschnitt** (erforderlich) -- der Handle der Sektion, zu der der Eintrag gehört
3. **Eintragstyp** -- der Handle des Eintragstyps
4. **Feld-Handle** (erforderlich) -- der Handle des Assets-Felds am Eintrag (z. B. `heroImage`, `Bilder`)
5. **Asset-IDs** (erforderlich) -- kommagetrennte Liste von Asset-IDs, die angehängt werden sollen (z. B. `123,456`). Ersetzt alle vorhandenen Assets im Feld
6. **Autor-ID** -- die numerische ID des Autors des Eintrags. Überschreibt die in den Anmeldedaten festgelegte Standard-Autor-ID

### Asset löschen

1. **Asset-ID** (erforderlich) -- die numerische ID des zu löschenden Assets

## Häufige Anwendungsfälle

* Automatisches Erstellen und Veröffentlichen von Blog-Einträgen aus KI-generierten Inhalten
* Massenweises Aktualisieren von Eintragsstatus basierend auf Workflow-Bedingungen
* Anfügen generierter oder hochgeladener Bilder an Einträge als Hero-Assets
* Abrufen von Einträgen per Slug, um vorhandene Inhalte anzureichern oder umzuschreiben
* Erstellen von Content-Pipelines, die Einträge als Entwurf anlegen und nach der Prüfung veröffentlichen
* Programmgesteiniges Bereinigen abgelaufener oder veralteter Einträge und Assets

{% hint style="info" %}
Hinweis: Die Craft-CMS-Integration erfordert ein GraphQL-Token mit entsprechenden Berechtigungen. Stellen Sie sicher, dass Ihr Token Zugriff auf die Sektionen und Volumes gewährt, die Sie verwenden möchten.
{% 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/craft-cms.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.
