Référence des autorisations

Les autorisations déterminent ce qu’une clé API a le droit de faire. Vous les cochez lorsque vous créez ou modifiez une clé dans Settings > API keys, et vous pouvez les changer plus tard sans renouveler la clé. Une clé n’obtient jamais plus que son propriétaire : les autorisations ne font que restreindre ce que vous pouvez déjà faire dans l’application.

Fonctionnement des autorisations

• Chaque route REST accepte une liste d’autorisations. La clé doit en posséder au moins une. Les pages de référence les indiquent pour chaque endpoint, et chacune renvoie à sa ligne ci-dessous.
• Chaque outil MCP exige exactement une autorisation. Une clé qui ne la possède pas ne voit pas l’outil dans tools/list, et l’appeler renvoie la même erreur que l’appel d’un outil inexistant.
• Les autorisations marquées MCP fonctionnent des deux côtés. Elles contrôlent au moins un outil MCP en plus de routes REST. Toutes les autres concernent uniquement REST. Le même badge figure à côté des autorisations dans l’application.
• Les trois verbes. _get lit, _manage crée, met à jour et exécute, _delete supprime. La suppression est toujours une autorisation à part : vous pouvez donc accorder à une intégration un accès en écriture sans lui donner le pouvoir de supprimer quoi que ce soit.
• Les règles de l’espace de travail s’appliquent toujours. L’accès aux modèles, la résidence des données et les garde-fous sont appliqués à chaque appel, et les connexions d’intégration conservent leur propre niveau d’accès (par exemple, une connexion de base de données réglée sur Read only n’accepte que SELECT, quelles que soient les autorisations de la clé).

Lorsqu’il manque une autorisation à une clé, REST répond :

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

Toutes les autorisations

Chat et conversations

Autorisation	Ce qu’elle débloque	MCP
conversations_get	Lire les conversations et leurs messages, suivre une conversation en direct sur son WebSocket, lister les fichiers d’une conversation, exporter des messages. MCP : get_conversation, list_conversations.	MCP
conversations_manage	Créer des conversations et envoyer des messages, créer une branche (fork), relancer, partager, comparer des modèles (sous-conversations), ajouter ou retirer des agents dans une conversation. MCP : send_message.	MCP
conversations_delete	DELETE /conversation/:id. MCP : delete_conversation.	MCP
search	GET /search dans vos prompts et vos conversations. MCP : search.	MCP

Prompts et exécutions

Autorisation	Ce qu’elle débloque	MCP
prompts_get	Lister et lire les prompts, les favoris, l’historique des exécutions, les instances, les partages et les fichiers de prompt. MCP : list_prompts, get_prompt.	MCP
prompts_manage	Créer, mettre à jour, dupliquer, déplacer et partager des prompts ; versions, favoris, instances et fichiers de prompt.	-
prompts_delete	DELETE /prompt/:id.	-
prompt_variables_manage	POST /variable, PUT /variable/:id.	-
prompt_variables_delete	DELETE /variable/:id.	-
run_prompt	Exécuter des prompts enregistrés et des instances (POST /instance/:id/run, les raccourcis /run/prompt/...). MCP : run_prompt.	MCP
custom_run	POST /run : envoyer du texte libre à un modèle sans prompt enregistré. MCP : custom_run.	MCP
ai_models_get	GET /ai_model, /ai_model/:id, /ai_model/filters, /ai_model/restricted. MCP : list_ai_models.	MCP

Agents et workflows

Autorisation	Ce qu’elle débloque	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	Lister et lire les tâches de workflow et leurs exécutions. MCP : list_workflow_tasks, get_workflow_task.	MCP
workflow_tasks_manage	Créer et mettre à jour des tâches de workflow, lancer une exécution manuelle. MCP : run_workflow_task.	MCP
workflow_tasks_delete	DELETE /workflow-tasks/:id.	-
mcp_get	GET /mcp, GET /mcp/:id : vos serveurs MCP distants configurés (ceux que les agents et les chats appellent).	-
mcp_manage	POST /mcp, PUT /mcp/:id.	-
mcp_delete	DELETE /mcp/:id.	-

Connaissances, fichiers et feuilles de calcul

Autorisation	Ce qu’elle débloque	MCP
knowledge_bases_get	Lister et lire les bases de connaissances et leurs dossiers. MCP : list_knowledge_bases, search_knowledge_base.	MCP
knowledge_bases_manage	Créer, mettre à jour et partager des bases de connaissances et des dossiers ; téléverser et supprimer des fichiers de base de connaissances.	-
knowledge_bases_delete	DELETE /knowledge-bases/:id.	-
files_get	GET /file. MCP : list_files, get_file.	MCP
files_manage	POST /file (téléversement), 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	Démarrer, mettre en pause et reprendre le traitement de feuilles de calcul. MCP : start_spreadsheet_processing, pause_spreadsheet_processing, resume_spreadsheet_processing.	MCP

Projets, équipes et espace de travail

Autorisation	Ce qu’elle débloque	MCP
projects_get	Lister et lire les projets, les projets épinglés et les fichiers de projet. MCP : list_projects, get_project.	MCP
projects_manage	Créer, mettre à jour, épingler et partager des projets ; fichiers de projet. 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	Créer et mettre à jour des équipes ; ajouter, modifier et retirer des membres.	-
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.	-

Génération de médias et transcription

Autorisation	Ce qu’elle débloque	MCP
image_generation_manage	POST /image_generation, POST /image_generation/edit. MCP : generate_image, edit_image.	MCP
video_generation_get	Lister les modèles vidéo, lister et lire les générations de vidéos. MCP : get_video_generation_status.	MCP
video_generation_manage	Créer et relancer des générations de vidéos. MCP : generate_video.	MCP
video_generation_delete	Supprimer une génération de vidéo. MCP : delete_video_generation.	MCP
tts_generation_get	Lister les modèles de synthèse vocale, lister et lire les générations vocales. MCP : get_tts_generation_status.	MCP
tts_generation_manage	Créer et relancer des générations vocales. MCP : generate_speech.	MCP
tts_generation_delete	Supprimer une génération vocale. MCP : delete_tts_generation.	MCP
music_generation_get	Lister les modèles musicaux, lister et lire les générations musicales. MCP : get_music_generation_status.	MCP
music_generation_manage	Créer et relancer des générations musicales. MCP : generate_music.	MCP
music_generation_delete	Supprimer une génération musicale. MCP : delete_music_generation.	MCP
transcription_get	Lister les modèles de transcription, lister et lire les transcriptions. MCP : get_transcription_status.	MCP
transcription_manage	Créer et relancer des transcriptions, renommer les intervenants. MCP : transcribe.	MCP
transcription_delete	Supprimer une transcription. MCP : delete_transcription.	MCP

Decisions

Autorisation	Ce qu’elle débloque	MCP
decision_get	GET /decision_model, GET /decision, GET /decision/:id : lister les modèles de décision, lister et lire vos décisions.	-
decision_manage	POST /decision : exécuter une décision et l’enregistrer.	-
decision_delete	DELETE /decision/:id.	-

Intégrations

Autorisation	Ce qu’elle débloque	MCP
integrations_get	GET /integration (le catalogue des fournisseurs) et la clé publique du tunnel SSH.	-
integration_connections_get	GET /integration/connections.	-
integration_connections_manage	Connecter, reconnecter et mettre à jour des connexions.	-
integration_connections_delete	Supprimer une connexion.	-
integration_email_get	Lire les informations de la connexion e-mail. MCP : list_email_connections.	MCP
integration_email_manage	Envoyer des e-mails via un compte connecté. MCP : send_email.	MCP
integration_crm_get	Routes de lecture CRM (informations de connexion, contacts, affaires, listes, 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	Créer et modifier des contacts CRM, créer des affaires. MCP : add_crm_contact, edit_crm_contact, create_crm_deal. La connexion CRM elle-même doit aussi autoriser l’accès en écriture.	MCP
integration_database_get	Lire le schéma de la base de données et les informations de connexion. MCP : list_database_connections, list_database_tables, describe_database_tables.	MCP
integration_database_manage	Exécuter une requête sur une base de données connectée. MCP : run_database_query. Ce que la requête peut faire dépend du niveau d’autorisation propre à la connexion.	MCP
integration_storage_get	Parcourir, rechercher et lire des éléments d’un stockage cloud connecté. MCP : list_storage_connections, browse_storage_folder, search_storage_files, get_storage_entry.	MCP
integration_storage_manage	Importer des fichiers depuis un stockage cloud connecté et en exporter vers celui-ci. MCP : import_storage_files, export_file_to_storage.	MCP

Autorisations qui ne débloquent rien pour l’instant

Vous verrez peut-être prompt_variables_get, prompt_categories_get, prompt_categories_manage, prompt_categories_delete, image_generation_get et image_generation_delete dans la liste. Aucune route ni aucun outil MCP destiné aux clients ne les utilise aujourd’hui : les cocher n’a donc aucun effet.

Réservées à l’équipe StickyPrompts, non attribuables

statistics_get, ai_models_manage, invite_codes_get, invite_codes_manage et invite_codes_delete sont réservées à l’équipe StickyPrompts. Elles n’apparaissent pas dans la liste des autorisations, et toute demande visant à les attribuer à une clé est refusée avec 403 {"error":"You are using permissions that are restricted"}. C’est pourquoi l’outil MCP get_usage_statistics n’apparaît jamais pour les clés des clients. Les administrateurs consultent l’utilisation de l’espace de travail dans l’application, sous Utilisation, crédits et facturation.

Ensembles d’autorisations suggérés

Partez de l’un de ces ensembles et n’ajoutez que ce dont votre intégration se révèle avoir besoin.

Bot de reporting en lecture seule

Répond aux questions à partir d’une base de données et de vos documents, sans jamais rien écrire.

Autorisations	Pourquoi
ai_models_get, custom_run	Choisir un modèle et résumer les résultats.
integration_database_get	Trouver la connexion et lire le schéma.
integration_database_manage	Indispensable pour exécuter la moindre requête. Connectez la base de données en Read only afin que seules les instructions SELECT soient acceptées.
knowledge_bases_get	Rechercher du contexte dans les documents.

Chatbot

Un front-end (par exemple un bot Slack interne) qui dialogue avec vos agents et vos connaissances.

Autorisations	Pourquoi
ai_models_get	Choisir le modèle des nouvelles conversations.
conversations_manage, conversations_get	Démarrer des conversations, envoyer des messages et lire les réponses.
agents_get	Trouver les agents à solliciter par @mention ou avec lesquels discuter.
knowledge_bases_get	Transmettre des bases de connaissances à une conversation.

Générateur de contenu

Remplit vos prompts enregistrés et produit du texte et des images.

Autorisations	Pourquoi
ai_models_get	Choisir un modèle.
prompts_get, run_prompt	Trouver les prompts enregistrés et les exécuter avec des variables.
custom_run	Générations ponctuelles sans prompt enregistré.
image_generation_manage, files_get	Générer des images et retrouver les fichiers obtenus.

Assistant CRM

Recherche des contacts et des affaires, tient le CRM à jour et envoie des relances.

Autorisations	Pourquoi
integration_crm_get	Rechercher et lister les contacts et les affaires.
integration_crm_manage	Ajouter et modifier des contacts, créer des affaires. L’option Allow write access doit être activée sur la connexion CRM.
integration_email_get, integration_email_manage	Trouver la connexion e-mail et envoyer la relance.
ai_models_get, custom_run	Rédiger le texte de l’e-mail.

Voir aussi