Berechtigungsreferenz

Berechtigungen legen fest, was ein API-Schlüssel tun darf. Sie haken sie an, wenn Sie einen Schlüssel unter Settings > API keys erstellen oder bearbeiten, und können sie später ändern, ohne den Schlüssel zu rotieren. Ein Schlüssel bekommt nie mehr Rechte als sein Inhaber: Berechtigungen schränken nur ein, was Sie in der App ohnehin schon tun können.

So funktionieren Berechtigungen

• Jede REST-Route akzeptiert eine Liste von Berechtigungen. Der Schlüssel braucht mindestens eine davon. Die Referenzseiten zeigen sie bei jedem Endpunkt an, und jede verlinkt auf ihre Zeile weiter unten.
• Jedes MCP-Tool braucht genau eine Berechtigung. Ein Schlüssel ohne diese Berechtigung sieht das Tool nicht in tools/list, und ein Aufruf liefert denselben Fehler wie der Aufruf eines Tools, das es nicht gibt.
• Mit MCP markierte Berechtigungen wirken an beiden Stellen. Sie schalten neben REST-Routen auch mindestens ein MCP-Tool frei. Alle anderen gelten nur für REST. Dieselbe Markierung erscheint in der App neben den Berechtigungen.
• Die drei Verben. _get liest, _manage erstellt, ändert und führt aus, _delete löscht. Löschen ist immer eine eigene Berechtigung. So können Sie einer Integration Schreibzugriff geben, ohne ihr das Recht zum Entfernen zu geben.
• Die Regeln des Workspace gelten weiterhin. Modellzugriff, Datenresidenz und Guardrails werden bei jedem Aufruf durchgesetzt, und Verbindungen zu Integrationen behalten ihre eigene Zugriffsstufe. Eine Datenbankverbindung, die auf Read only steht, akzeptiert zum Beispiel nur SELECT, ganz gleich, welche Berechtigungen der Schlüssel hat.

Fehlt einem Schlüssel eine Berechtigung, antwortet REST mit:

HTTP 403
{"error": "This api key does not have any of the required permissions. You need at least one of: conversations_get"}

Alle Berechtigungen

Chat und Unterhaltungen

Berechtigung	Was sie freischaltet	MCP
conversations_get	Unterhaltungen und ihre Nachrichten lesen, eine Unterhaltung live über ihren WebSocket verfolgen, die Dateien einer Unterhaltung auflisten, Nachrichten exportieren. MCP: get_conversation, list_conversations.	MCP
conversations_manage	Unterhaltungen erstellen und Nachrichten senden, verzweigen, wiederholen, teilen, Modelle vergleichen (Unter-Unterhaltungen), Agenten zu einer Unterhaltung hinzufügen oder daraus entfernen. MCP: send_message.	MCP
conversations_delete	DELETE /conversation/:id. MCP: delete_conversation.	MCP
search	GET /search über Ihre Prompts und Unterhaltungen. MCP: search.	MCP

Prompts und Ausführungen

Berechtigung	Was sie freischaltet	MCP
prompts_get	Prompts, Favoriten, Ausführungsverlauf, Instanzen, Freigaben und Prompt-Dateien auflisten und lesen. MCP: list_prompts, get_prompt.	MCP
prompts_manage	Prompts erstellen, ändern, duplizieren, verschieben und teilen; Versionen, Favoriten, Instanzen und Prompt-Dateien.	-
prompts_delete	DELETE /prompt/:id.	-
prompt_variables_manage	POST /variable, PUT /variable/:id.	-
prompt_variables_delete	DELETE /variable/:id.	-
run_prompt	Gespeicherte Prompts und Instanzen ausführen (POST /instance/:id/run, die Kurzformen unter /run/prompt/...). MCP: run_prompt.	MCP
custom_run	POST /run: freien Text ohne gespeicherten Prompt an ein Modell senden. MCP: custom_run.	MCP
ai_models_get	GET /ai_model, /ai_model/:id, /ai_model/filters, /ai_model/restricted. MCP: list_ai_models.	MCP

Agenten und Workflows

Berechtigung	Was sie freischaltet	MCP
agents_get	GET /agents, GET /agents/:id. MCP: list_agents, get_agent.	MCP
agents_manage	POST /agents, PATCH /agents/:id.	-
agents_delete	DELETE /agents/:id.	-
workflow_tasks_get	Workflow-Aufgaben und ihre Ausführungen auflisten und lesen. MCP: list_workflow_tasks, get_workflow_task.	MCP
workflow_tasks_manage	Workflow-Aufgaben erstellen und ändern, eine manuelle Ausführung starten. MCP: run_workflow_task.	MCP
workflow_tasks_delete	DELETE /workflow-tasks/:id.	-
mcp_get	GET /mcp, GET /mcp/:id: Ihre konfigurierten Remote-MCP-Server (die Server, die Agenten und Chats aufrufen).	-
mcp_manage	POST /mcp, PUT /mcp/:id.	-
mcp_delete	DELETE /mcp/:id.	-

Wissen, Dateien und Tabellen

Berechtigung	Was sie freischaltet	MCP
knowledge_bases_get	Wissensdatenbanken und Ordner auflisten und lesen. MCP: list_knowledge_bases, search_knowledge_base.	MCP
knowledge_bases_manage	Wissensdatenbanken und Ordner erstellen, ändern und teilen; Dateien in Wissensdatenbanken hochladen und löschen.	-
knowledge_bases_delete	DELETE /knowledge-bases/:id.	-
files_get	GET /file. MCP: list_files, get_file.	MCP
files_manage	POST /file (Upload), POST /file/:id/public.	-
files_delete	DELETE /file/:id, DELETE /file/:id/public.	-
spreadsheet_processing_get	GET /xlsx/process-status/:taskId, GET /xlsx/history. MCP: list_spreadsheet_processing_tasks, get_spreadsheet_processing_task.	MCP
spreadsheet_processing_manage	Tabellenverarbeitung starten, pausieren und fortsetzen. MCP: start_spreadsheet_processing, pause_spreadsheet_processing, resume_spreadsheet_processing.	MCP

Projekte, Teams und Workspace

Berechtigung	Was sie freischaltet	MCP
projects_get	Projekte, angeheftete Projekte und Projektdateien auflisten und lesen. MCP: list_projects, get_project.	MCP
projects_manage	Projekte erstellen, ändern, anheften und teilen; Projektdateien. MCP: create_project.	MCP
projects_delete	DELETE /project/:id. MCP: delete_project.	MCP
teams_get	GET /teams, /teams/all, /teams/:id/members. MCP: list_teams, list_team_members.	MCP
teams_manage	Teams erstellen und ändern; Mitglieder hinzufügen, ändern und entfernen.	-
teams_delete	DELETE /teams/:id.	-
organization_get	GET /workspace. MCP: list_workspace_members.	MCP
organization_manage	PATCH /workspace, PATCH /workspace/user/permissions.	-
organization_delete	DELETE /workspace.	-

Mediengenerierung und Transkription

Berechtigung	Was sie freischaltet	MCP
image_generation_manage	POST /image_generation, POST /image_generation/edit. MCP: generate_image, edit_image.	MCP
video_generation_get	Videomodelle auflisten, Videogenerierungen auflisten und lesen. MCP: get_video_generation_status.	MCP
video_generation_manage	Videogenerierungen erstellen und wiederholen. MCP: generate_video.	MCP
video_generation_delete	Eine Videogenerierung löschen. MCP: delete_video_generation.	MCP
tts_generation_get	Sprachmodelle auflisten, Sprachgenerierungen auflisten und lesen. MCP: get_tts_generation_status.	MCP
tts_generation_manage	Sprachgenerierungen erstellen und wiederholen. MCP: generate_speech.	MCP
tts_generation_delete	Eine Sprachgenerierung löschen. MCP: delete_tts_generation.	MCP
music_generation_get	Musikmodelle auflisten, Musikgenerierungen auflisten und lesen. MCP: get_music_generation_status.	MCP
music_generation_manage	Musikgenerierungen erstellen und wiederholen. MCP: generate_music.	MCP
music_generation_delete	Eine Musikgenerierung löschen. MCP: delete_music_generation.	MCP
transcription_get	Transkriptionsmodelle auflisten, Transkriptionen auflisten und lesen. MCP: get_transcription_status.	MCP
transcription_manage	Transkriptionen erstellen und wiederholen, Sprecher umbenennen. MCP: transcribe.	MCP
transcription_delete	Eine Transkription löschen. MCP: delete_transcription.	MCP

Decisions

Berechtigung	Was sie freischaltet	MCP
decision_get	GET /decision_model, GET /decision, GET /decision/:id: die Entscheidungsmodelle auflisten, Ihre Entscheidungen auflisten und lesen.	-
decision_manage	POST /decision: eine Entscheidung ausführen und speichern.	-
decision_delete	DELETE /decision/:id.	-

Integrationen

Berechtigung	Was sie freischaltet	MCP
integrations_get	GET /integration (der Anbieterkatalog) und der öffentliche Schlüssel für den SSH-Tunnel.	-
integration_connections_get	GET /integration/connections.	-
integration_connections_manage	Verbindungen herstellen, neu verbinden und ändern.	-
integration_connections_delete	Eine Verbindung löschen.	-
integration_email_get	Informationen zur E-Mail-Verbindung lesen. MCP: list_email_connections.	MCP
integration_email_manage	E-Mails über ein verbundenes Konto senden. MCP: send_email.	MCP
integration_crm_get	Lesende CRM-Routen (Verbindungsinformationen, Kontakte, Deals, Listen, Tags). MCP: list_crm_connections, search_crm_contacts, list_crm_contacts, search_crm_deals, list_crm_deals, list_crm_lists, list_crm_tags.	MCP
integration_crm_manage	CRM-Kontakte anlegen und bearbeiten, Deals anlegen. MCP: add_crm_contact, edit_crm_contact, create_crm_deal. Auch die CRM-Verbindung selbst muss Schreibzugriff erlauben.	MCP
integration_database_get	Datenbankschema und Verbindungsinformationen lesen. MCP: list_database_connections, list_database_tables, describe_database_tables.	MCP
integration_database_manage	Eine Abfrage auf einer verbundenen Datenbank ausführen. MCP: run_database_query. Was die Abfrage tun darf, bestimmt die Berechtigungsstufe der Verbindung selbst.	MCP
integration_storage_get	Einträge in einem verbundenen Cloud-Speicher durchsuchen, finden und lesen. MCP: list_storage_connections, browse_storage_folder, search_storage_files, get_storage_entry.	MCP
integration_storage_manage	Dateien aus einem verbundenen Cloud-Speicher importieren und dorthin exportieren. MCP: import_storage_files, export_file_to_storage.	MCP

Berechtigungen, die derzeit nichts freischalten

In der Liste sehen Sie unter Umständen prompt_variables_get, prompt_categories_get, prompt_categories_manage, prompt_categories_delete, image_generation_get und image_generation_delete. Derzeit nutzt keine Route und kein MCP-Tool für Kunden diese Berechtigungen. Sie anzuhaken, hat daher keine Wirkung.

Nur für Mitarbeiter, nicht vergebbar

statistics_get, ai_models_manage, invite_codes_get, invite_codes_manage und invite_codes_delete sind StickyPrompts-Mitarbeitern vorbehalten. Sie erscheinen nicht in der Berechtigungsliste, und ein Versuch, sie einem Schlüssel zuzuweisen, wird mit 403 {"error":"You are using permissions that are restricted"} abgelehnt. Deshalb taucht das MCP-Tool get_usage_statistics bei Kundenschlüsseln nie auf. Die Nutzung des Workspace sehen Admins in der App unter Nutzung, Credits und Abrechnung.

Empfohlene Berechtigungssätze

Beginnen Sie mit einem dieser Sätze und ergänzen Sie nur das, was Ihre Integration tatsächlich braucht.

Reporting-Bot mit reinem Lesezugriff

Beantwortet Fragen anhand einer Datenbank und Ihrer Dokumente und schreibt nichts zurück.

Berechtigungen	Warum
ai_models_get, custom_run	Ein Modell wählen und die Ergebnisse zusammenfassen.
integration_database_get	Die Verbindung finden und das Schema lesen.
integration_database_manage	Nötig, um überhaupt eine Abfrage auszuführen. Verbinden Sie die Datenbank mit Read only, damit nur SELECT-Anweisungen akzeptiert werden.
knowledge_bases_get	Dokumente nach Kontext durchsuchen.

Chatbot

Ein Frontend (zum Beispiel ein interner Slack-Bot), das mit Ihren Agenten und Ihrem Wissen spricht.

Berechtigungen	Warum
ai_models_get	Das Modell für neue Unterhaltungen wählen.
conversations_manage, conversations_get	Unterhaltungen starten, Nachrichten senden und Antworten lesen.
agents_get	Agenten finden, die per @mention erwähnt oder direkt angesprochen werden sollen.
knowledge_bases_get	Wissensdatenbanken an eine Unterhaltung übergeben.

Content-Generator

Füllt Ihre gespeicherten Prompts aus und erzeugt Texte und Bilder.

Berechtigungen	Warum
ai_models_get	Ein Modell wählen.
prompts_get, run_prompt	Gespeicherte Prompts finden und mit Variablen ausführen.
custom_run	Einmalige Generierungen ohne gespeicherten Prompt.
image_generation_manage, files_get	Bilder generieren und die entstandenen Dateien abrufen.

CRM-Assistent

Sucht Kontakte und Deals heraus, hält das CRM aktuell und verschickt Follow-ups.

Berechtigungen	Warum
integration_crm_get	Kontakte und Deals suchen und auflisten.
integration_crm_manage	Kontakte anlegen und bearbeiten, Deals anlegen. Bei der CRM-Verbindung muss Allow write access eingeschaltet sein.
integration_email_get, integration_email_manage	Die E-Mail-Verbindung finden und das Follow-up senden.
ai_models_get, custom_run	Den Text der E-Mail entwerfen.

Verwandte Seiten