Alle 15 Scopes für API-Keys und KI-Verbindungen: was jeder Scope erlaubt, wie er im Dashboard heißt und was mit keinem API-Key möglich ist.
Scopes legen fest, was ein API-Key darf. Dieselben 15 Scopes gelten auch für KI-Assistenten, die du per MCP verbindest. Wähle immer nur die Scopes, die eine Anwendung wirklich braucht.
Grundregeln
- Jeder Endpunkt verlangt genau einen Scope
- Bei API-Keys schließt write:X automatisch read:X ein – im Dashboard steht dazu „write:X schließt read:X automatisch ein“
- Fehlt der Scope, antwortet die API mit 403 insufficient_scope und nennt den benötigten Scope in details.required_scope
- Endpunkte, die für API-Keys gar nicht freigegeben sind, antworten ebenfalls mit 403 insufficient_scope
- Eigentümer- und Admin-Funktionen wie Mitglieder, Abrechnung oder Domains verwalten sind mit keinem Scope erreichbar
Alle Scopes
Im Dialog „Neuen API-Key erstellen“ wählst du pro Bereich „Lesen“ oder „Schreiben“; in der Key-Liste stehen die Scope-Namen aus der ersten Spalte. Die Schreibweise „Lesen · Pages“ siehst du auf der Zustimmungsseite für KI-Apps und unter „Verbundene Apps“.
| Scope | Bei KI-Apps | Erlaubt |
|---|---|---|
| read:pages | Lesen · Pages | Pages auflisten und lesen, Entwurf lesen und prüfen, Blöcke auflisten, SEO lesen, Versionen auflisten, Blocktypen abrufen |
| write:pages | Schreiben · Pages | Pages anlegen und ändern (auch Handle), Entwurf ändern, Blöcke anlegen, ändern, löschen und sortieren, SEO ändern, Sichtbarkeit, Veröffentlichen, Version zurückholen, Einladungslinks für private Pages |
| read:links | Lesen · Links | Links einer Page auflisten und lesen |
| write:links | Schreiben · Links | Links anlegen, ändern, löschen und sortieren |
| read:assets | Lesen · Assets | Assets auflisten |
| write:assets | Schreiben · Assets | Assets hochladen und löschen, Uploads für eine Page |
| read:forms | Lesen · Formulare | Formulare lesen, Zusammenfassung, Einsendungen auflisten und als CSV exportieren (Export ab Creator Pro) |
| write:forms | Schreiben · Formulare | Formulare anlegen, ändern und löschen |
| read:stats | Lesen · Statistiken | Statistiken von Pages und Workspace (Zusammenfassung, Verlauf, Vergleich, Links, Widgets, Conversions, Top-Pages), Push-Verlauf und Push-Nutzung |
| read:workspaces | Lesen · Workspaces | Plan-Funktionen, Nutzung, Mitgliederliste, Workspace-Einstellungen lesen, Domains auflisten, Templates auflisten und lesen, Callback-Secrets auflisten und lesen (ohne Secret im Klartext) |
| write:workspaces | Schreiben · Workspaces | Derzeit keine zusätzlichen Endpunkte über read:workspaces hinaus |
| read:donations | Lesen · Unterstützungen | Summen der Unterstützungen (Zahlungen über den Block „Unterstützen“) des Workspaces |
| read:short_links | Lesen · Short Links | Short Links auflisten und lesen |
| write:short_links | Schreiben · Short Links | Short Links anlegen, ändern und löschen |
| write:templates | Schreiben · Workspace-Templates | Eigene Workspace-Templates anlegen, ändern und löschen (gelesen werden sie mit read:workspaces), siehe Eigene Templates |
Welche Endpunkte genau zu welchem Scope gehören, zeigt Endpunkte nach Bereich.
Was mit keinem API-Key geht
- Pages löschen
- Vorschau-Links für den Entwurf erzeugen
- Statistik-Aufschlüsselungen nach Gerät, Land, Referrer und UTM
- Push-Nachrichten senden und Push-Regeln verwalten
- Integrationen verbinden oder trennen
- Webhooks verwalten
- Domains anlegen, prüfen, aktivieren, deaktivieren oder löschen
- Mitglieder, Einladungen und Rollen verwalten, das Eigentum übertragen
- Workspace-Einstellungen ändern, Abrechnung
- Callback-Secrets anlegen, ändern, rotieren oder löschen
- Liste der Unterstützungen, Auskunft und Anonymisierung von Formular-Einsendungen
- Profil, Abonnements und API-Keys selbst verwalten
Diese Funktionen erledigst du im Dashboard.
Scopes bei KI-Assistenten
Bei einer MCP-Verbindung wählst du dieselben Scopes auf der Zustimmungsseite. Zwei Unterschiede: Erstens schließt dort ein Schreibrecht das Leserecht nicht ein – gib also beide frei. Zweitens begrenzt deine Rolle die Auswahl: Viewer bekommen nur Leserechte (ohne Formulare und Short Links), Editoren alles außer „Schreiben · Workspaces“, Short Links und Workspace-Templates. Mehr unter Rechte, Sicherheit und Limits.
Empfohlene Kombinationen
| Anwendung | Scopes |
|---|---|
| Reporting und Dashboards | read:stats, read:pages |
| Links aus einem CMS oder Shop synchronisieren | write:links, read:pages |
| Pages automatisch pflegen und veröffentlichen | write:pages, write:links |
| Kampagnen-Links aus dem CRM | write:short_links |
| Leads aus Formularen ins CRM übernehmen | read:forms |
| Templates aus einer CI-Pipeline ausrollen | write:templates, read:workspaces |
Das könnte auch helfen
Nichts gefunden?
Schreib uns dein Anliegen – unser Support hilft dir persönlich weiter.