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

# Sanity

Die Sanity-Integration ermöglicht es Ihnen, Inhalte auf Ihrer Sanity.io-Website aufzulisten, zu erstellen, zu aktualisieren und abzufragen.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-a83f5e32ccae943e7ee425b6b518a607d6bbfd0a%2Fsanity-step-01-list-resources.png?alt=media" alt="Sanity Integration step set to List Resources for the spaceops-site project, the production dataset, and the post resource type"><figcaption><p>Beispielschritt zum Auflisten von Sanity-Ressourcen.</p></figcaption></figure>

## Authentifizierung

1. **API-Schlüssel generieren**
   1. Gehe zu deinem Projekt-Dashboard auf Sanity.io
   2. Gehe zum API-Tab
   3. Klicke auf die Schaltfläche "API-Token hinzufügen"
   4. Gib deinem Token einen Namen (z. B. "AirOps")
   5. Setze die Berechtigungen auf "Editor"
   6. Klicke auf "Speichern"
   7. Kopiere den generierten Token
2. **Füge den API-Schlüssel zu AirOps hinzu**
   1. Gehe zur Seite AirOps > Settings > Integrations
   2. Klicke auf "Neu hinzufügen" und wähle Sanity aus
   3. Füge den generierten Token in das API-Key-Feld ein
   4. Klicke auf "Speichern"

**Sicherheitshinweis:** Behandle deinen API-Schlüssel wie ein Passwort. Er gewährt REST-API-Zugriff auf deine Sanity-Instanz und sollte nicht weitergegeben werden. Bewahre ihn sicher auf und verwende ihn nur in serverseitigen oder sicheren/authentifizierten Umgebungen.

## Funktionen und ihre Parameter <a href="#user-content-functions-and-their-parameters" id="user-content-functions-and-their-parameters"></a>

#### Allgemeine Konfigurationsparameter

1. **Projekt-ID**: Die ID deines Sanity-Projekts. (z. B. "w22x3y4z")
2. **Datensatz**: Der Datensatz, den du verwenden möchtest. (z. B. "production")

### **Ressourcen auflisten**

Ruft eine Liste von Ressourcen aus deinem Sanity-Projekt ab. Das ist nützlich, um vorhandene Beiträge, Bilder oder andere Inhaltstypen abzurufen. Gibt 100 Datensätze pro Seite zurück.

1. **Ressourcentyp**: Der Typ der Ressource, die du auflisten möchtest. (z. B. "post")
2. **Letzte ID**: Um die Paginierung zu verwenden, kannst du die letzte ID der vorherigen Anfrage angeben. (Optional)
3. **Entwürfe einschließen?**: Ob Entwurfsressourcen in den Ergebnissen enthalten sein sollen. (Optional)

### **Ressource abrufen**

Ruft eine einzelne Ressource aus deinem Sanity-Projekt ab. Das ist nützlich, um detaillierte Informationen zu einem bestimmten Beitrag oder Bild abzurufen.

Das Array von Blöcken wird unverändert zurückgegeben, aber eine begleitende Datenstruktur wird zurückgegeben, bei der die Block-Attribute in reines HTML umgewandelt werden innerhalb des `__airops.html` JSON-Pfad.

1. **Ressourcen-ID**: Die ID der Ressource, die du abrufen möchtest. (z. B. "4ddb0459-2734-4611-b1af-4ee13f3d5630")

### **Ressource erstellen**

Erstellt eine neue Ressource in deinem Sanity-Projekt. Das ist nützlich, um neue Beiträge, Bilder oder andere Inhaltstypen hinzuzufügen.

1. **Ressourcen-JSON**: Das JSON-Objekt, das die Ressource darstellt, die du erstellen möchtest.
   * Zum Beispiel: `{ "title": "Mein neuer Beitrag", "category": "blog" }`
   * Wenn es zusammen mit dem Ressource-HTML-Eingabefeld verwendet wird, werden HTML-Attribute aus dieser Eingabe ignoriert.
   * Siehe <https://www.sanity.io/docs/js-client#creating-documents>.
2. **Ressourcen-HTML**: Ein JSON-Objekt, das den Namen des Ressourcenattributs als Schlüssel und das HTML-Dokument als Wert enthält. (Optional)
   * Zum Beispiel: `{ "body": "<h1>Mein neuer Beitrag</h1><p>Dies ist der Inhalt meines neuen Beitrags.</p>" }`
   * Das ist nützlich, um Beiträge mit Rich-Text-Inhalten zu erstellen.
   * Das HTML wird in Sanitys Portable-Text-Struktur konvertiert und im Payload verwendet, um die Ressource zu erstellen. Sende so viele HTML-Attribute wie nötig.

### **Ressource aktualisieren**

Aktualisiert eine vorhandene Ressource in deinem Sanity-Projekt.

1. **Ressourcen-ID**: Die ID der Ressource, die du aktualisieren möchtest. (z. B. "4ddb0459-2734-4611-b1af-4ee13f3d5630")
2. **Ressourcen-JSON**: Das JSON-Objekt, das die Ressource darstellt, die du aktualisieren möchtest.
   * Zum Beispiel: `{ "title": "Mein aktualisierter Beitrag", "category": "blog" }`
   * Wenn es zusammen mit dem Ressource-HTML-Eingabefeld verwendet wird, werden HTML-Attribute aus dieser Eingabe ignoriert.
   * Siehe <https://www.sanity.io/docs/js-client#patchupdate-a-document>.
3. **Ressourcen-HTML**: Ein JSON-Objekt, das den Namen des Ressourcenattributs als Schlüssel und das HTML-Dokument als Wert enthält. (Optional)
   * Zum Beispiel: `{ "body": "<h1>Mein neuer Beitrag</h1><p>Dies ist der Inhalt meines neuen Beitrags.</p>" }`
   * Das ist nützlich, um Beiträge mit Rich-Text-Inhalten zu erstellen.
   * Das HTML wird in Sanitys Portable-Text-Struktur konvertiert und im Payload verwendet, um die Ressource zu erstellen. Sende so viele HTML-Attribute wie nötig.

### **Bild hochladen**

Lädt ein Bild in dein Sanity-Projekt hoch. Das ist nützlich, um Bilder zu deinem Inhalt oder deiner Medienbibliothek hinzuzufügen.

1. **Bild-URL**: Die URL des Bildes, das du zu Sanity hochladen möchtest. (z. B. "<https://example.com/image.jpg>")

### **Ressource veröffentlichen**

Veröffentlicht eine Entwurfsressource in deinem Sanity-Projekt, sodass sie live und für dein Publikum sichtbar wird.

1. **Ressourcen-ID**: Die ID der Entwurfsressource, die du veröffentlichen möchtest. (z. B. "drafts.4ddb0459-2734-4611-b1af-4ee13f3d5630")

### **Abfrage ausführen**

Führt eine beliebige [GROQ](https://www.sanity.io/docs/groq) Abfrage gegen dein Sanity-Projekt aus. Das ist nützlich, um Daten mit benutzerdefiniertem Filtern, Sortieren oder Projektionen abzurufen, die über die integrierte Aktion „Ressourcen auflisten“ hinausgehen.

1. **Abfrage**: Die GROQ-Abfrage, die gegen deinen Datensatz ausgeführt werden soll. (z. B. `*[_type == "post" && status == "published"] | order(publishedAt desc) { _id, title, slug, publishedAt }`)
2. **Abfrageparameter**: Ein JSON-Objekt mit benannten Parametern, die an die Abfrage übergeben werden sollen. (Optional)
   * Zum Beispiel: `{ "status": "published" }` kann mit einer Abfrage wie `*[_type == "post" && status == $status]`
   * Siehe <https://www.sanity.io/docs/query-cheat-sheet> für die GROQ-Syntaxreferenz.


---

# 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/sanity.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.
