REST-API: API-Schlüssel und Berechtigungen

Mit der REST-API kannst du per Code Ideen einreichen, die nächsten Posts und den Wochenplan abrufen oder Entwürfe anlegen. Die Anmeldung läuft über einen API-Schlüssel: Jede Anfrage trägt den Header Authorization: Bearer <Schlüssel>.

Bevor du startest

• Nur ein Inhaber des Workspace kann API-Schlüssel anlegen und widerrufen.
• Im Solo-Tarif können Schlüssel nur lesen; zum Schreiben brauchst du Pro oder höher. Ist die Testphase abgelaufen oder das Abo nicht aktiv, können Schlüssel nur lesen.

Schlüssel anlegen

1. 1Öffne Einstellungen → Alle Integrationen und klick auf die Karte REST API.
2. 2Gib ein, wofür der Schlüssel gedacht ist (der Feldhinweis lautet Wofür? (z. B. Zapier)).
3. 3Klick auf Neuer Schlüssel.
4. 4Kopiere den Schlüssel mit Kopieren – du siehst ihn nur jetzt (API-Schlüssel (siehst du nur jetzt):).

Ein hier angelegter Schlüssel kann lesen und schreiben (Entwürfe, Ideen), aber nicht freigeben. Willst du die Berechtigungen selbst wählen, öffne die Karte Claude & ChatGPT (MCP), setz die Haken unter API-Schlüssel mit Berechtigungen und klick auf Schlüssel erstellen.

Berechtigungen

• read – Marken, Kanäle, Plan, Posts, Ideen, Kalender-Übersicht, Statistik.
• write – Entwürfe schreiben und bearbeiten, Ideen anlegen, Woche generieren, nicht gesendete Posts löschen.
• approve – Freigabe, also echtes Einplanen. Dafür muss der Workspace es auch unter Freigaben durch Assistenten erlauben, und alle Freigaberegeln gelten.

Häufige Endpunkte

Idee einreichen: POST /api/v1/ideas {"text":"…"} · nächste Posts: GET /api/v1/posts?days=14 · Wochenplan: GET /api/v1/week. Die vollständige Liste, Fehlercodes und Limits pro Minute stehen auf der Entwicklerseite.

Schlüssel widerrufen

1. 1Öffne die Karte REST API.
2. 2Klick in der Zeile des Schlüssels auf Widerrufen und bestätige. Alles, was ihn nutzt, funktioniert sofort nicht mehr.