Referencia de permisos

Los permisos determinan lo que puede hacer una clave de API. Los marcas al crear o editar una clave en Settings > API keys, y puedes cambiarlos más adelante sin rotar la clave. Una clave nunca obtiene más de lo que tiene su propietario: los permisos solo restringen lo que ya puedes hacer en la aplicación.

Cómo funcionan los permisos

• Cada ruta REST acepta una lista de permisos. La clave necesita al menos uno de ellos. Las páginas de referencia los muestran en cada endpoint, y cada uno enlaza con su fila en esta página.
• Cada herramienta MCP necesita exactamente un permiso. Una clave que no lo tiene no ve la herramienta en tools/list, y llamarla devuelve el mismo error que llamar a una herramienta que no existe.
• Los permisos marcados con MCP funcionan en ambos sitios. Controlan el acceso a al menos una herramienta MCP, además de a rutas REST. Todos los demás son solo de REST. La misma insignia aparece junto a los permisos en la aplicación.
• Los tres verbos. _get lee; _manage crea, actualiza y ejecuta; _delete elimina. La eliminación siempre es un permiso aparte, así que puedes dar a una integración acceso de escritura sin la capacidad de borrar nada.
• Las reglas del espacio de trabajo se siguen aplicando. El acceso a modelos, la residencia de datos y los guardrails se aplican en cada llamada, y las conexiones de integración conservan su propio nivel de acceso (por ejemplo, una conexión de base de datos configurada como Read only solo acepta SELECT, tenga la clave los permisos que tenga).

Cuando a una clave le falta un permiso, REST responde:

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

Todos los permisos

Chat y conversaciones

Permiso	Qué desbloquea	MCP
conversations_get	Leer conversaciones y sus mensajes, seguir una conversación en directo por su WebSocket, listar los archivos de una conversación y exportar mensajes. MCP: get_conversation, list_conversations.	MCP
conversations_manage	Crear conversaciones y enviar mensajes, bifurcar, reintentar, compartir, comparar modelos (subconversaciones) y añadir o quitar agentes de una conversación. MCP: send_message.	MCP
conversations_delete	DELETE /conversation/:id. MCP: delete_conversation.	MCP
search	GET /search en tus prompts y conversaciones. MCP: search.	MCP

Prompts y ejecuciones

Permiso	Qué desbloquea	MCP
prompts_get	Listar y leer prompts, favoritos, historial de ejecuciones, instancias, uso compartido y archivos de prompts. MCP: list_prompts, get_prompt.	MCP
prompts_manage	Crear, actualizar, duplicar, mover y compartir prompts; versiones, favoritos, instancias y archivos de prompts.	-
prompts_delete	DELETE /prompt/:id.	-
prompt_variables_manage	POST /variable, PUT /variable/:id.	-
prompt_variables_delete	DELETE /variable/:id.	-
run_prompt	Ejecutar prompts guardados e instancias (POST /instance/:id/run y los atajos /run/prompt/...). MCP: run_prompt.	MCP
custom_run	POST /run: enviar texto libre a un modelo sin un prompt guardado. MCP: custom_run.	MCP
ai_models_get	GET /ai_model, /ai_model/:id, /ai_model/filters, /ai_model/restricted. MCP: list_ai_models.	MCP

Agentes y flujos de trabajo

Permiso	Qué desbloquea	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	Listar y leer tareas de flujos de trabajo y sus ejecuciones. MCP: list_workflow_tasks, get_workflow_task.	MCP
workflow_tasks_manage	Crear y actualizar tareas de flujos de trabajo e iniciar una ejecución manual. MCP: run_workflow_task.	MCP
workflow_tasks_delete	DELETE /workflow-tasks/:id.	-
mcp_get	GET /mcp, GET /mcp/:id: tus servidores MCP remotos configurados (a los que llaman los agentes y los chats).	-
mcp_manage	POST /mcp, PUT /mcp/:id.	-
mcp_delete	DELETE /mcp/:id.	-

Conocimiento, archivos y hojas de cálculo

Permiso	Qué desbloquea	MCP
knowledge_bases_get	Listar y leer bases de conocimiento y carpetas. MCP: list_knowledge_bases, search_knowledge_base.	MCP
knowledge_bases_manage	Crear, actualizar y compartir bases de conocimiento y carpetas; subir y eliminar archivos de las bases de conocimiento.	-
knowledge_bases_delete	DELETE /knowledge-bases/:id.	-
files_get	GET /file. MCP: list_files, get_file.	MCP
files_manage	POST /file (subida), 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	Iniciar, pausar y reanudar el procesamiento de hojas de cálculo. MCP: start_spreadsheet_processing, pause_spreadsheet_processing, resume_spreadsheet_processing.	MCP

Proyectos, equipos y espacio de trabajo

Permiso	Qué desbloquea	MCP
projects_get	Listar y leer proyectos, proyectos fijados y archivos de proyectos. MCP: list_projects, get_project.	MCP
projects_manage	Crear, actualizar, fijar y compartir proyectos; archivos de proyectos. 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	Crear y actualizar equipos; añadir, actualizar y quitar miembros.	-
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.	-

Generación multimedia y transcripción

Permiso	Qué desbloquea	MCP
image_generation_manage	POST /image_generation, POST /image_generation/edit. MCP: generate_image, edit_image.	MCP
video_generation_get	Listar los modelos de vídeo, y listar y leer generaciones de vídeo. MCP: get_video_generation_status.	MCP
video_generation_manage	Crear y reintentar generaciones de vídeo. MCP: generate_video.	MCP
video_generation_delete	Eliminar una generación de vídeo. MCP: delete_video_generation.	MCP
tts_generation_get	Listar los modelos de voz, y listar y leer generaciones de voz. MCP: get_tts_generation_status.	MCP
tts_generation_manage	Crear y reintentar generaciones de voz. MCP: generate_speech.	MCP
tts_generation_delete	Eliminar una generación de voz. MCP: delete_tts_generation.	MCP
music_generation_get	Listar los modelos de música, y listar y leer generaciones de música. MCP: get_music_generation_status.	MCP
music_generation_manage	Crear y reintentar generaciones de música. MCP: generate_music.	MCP
music_generation_delete	Eliminar una generación de música. MCP: delete_music_generation.	MCP
transcription_get	Listar los modelos de transcripción, y listar y leer transcripciones. MCP: get_transcription_status.	MCP
transcription_manage	Crear y reintentar transcripciones y renombrar a los hablantes. MCP: transcribe.	MCP
transcription_delete	Eliminar una transcripción. MCP: delete_transcription.	MCP

Decisions

Permiso	Qué desbloquea	MCP
decision_get	GET /decision_model, GET /decision, GET /decision/:id: listar los modelos de decisión, y listar y leer tus decisiones.	-
decision_manage	POST /decision: ejecutar una decisión y guardarla.	-
decision_delete	DELETE /decision/:id.	-

Integraciones

Permiso	Qué desbloquea	MCP
integrations_get	GET /integration (el catálogo de proveedores) y la clave pública del túnel SSH.	-
integration_connections_get	GET /integration/connections.	-
integration_connections_manage	Conectar, reconectar y actualizar conexiones.	-
integration_connections_delete	Eliminar una conexión.	-
integration_email_get	Leer la información de la conexión de correo electrónico. MCP: list_email_connections.	MCP
integration_email_manage	Enviar correos electrónicos a través de una cuenta conectada. MCP: send_email.	MCP
integration_crm_get	Rutas de lectura del CRM (información de la conexión, contactos, tratos, listas y etiquetas). 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	Crear y editar contactos del CRM y crear tratos. MCP: add_crm_contact, edit_crm_contact, create_crm_deal. La propia conexión del CRM también debe permitir el acceso de escritura.	MCP
integration_database_get	Leer el esquema de la base de datos y la información de la conexión. MCP: list_database_connections, list_database_tables, describe_database_tables.	MCP
integration_database_manage	Ejecutar una consulta en una base de datos conectada. MCP: run_database_query. Lo que puede hacer la consulta lo determina el nivel de permisos de la propia conexión.	MCP
integration_storage_get	Explorar, buscar y leer elementos de una unidad en la nube conectada. MCP: list_storage_connections, browse_storage_folder, search_storage_files, get_storage_entry.	MCP
integration_storage_manage	Importar archivos desde una unidad en la nube conectada y exportar archivos a ella. MCP: import_storage_files, export_file_to_storage.	MCP

Permisos que por ahora no desbloquean nada

Puede que veas prompt_variables_get, prompt_categories_get, prompt_categories_manage, prompt_categories_delete, image_generation_get e image_generation_delete en la lista. Hoy en día ninguna ruta ni herramienta MCP disponible para los clientes los usa, así que marcarlos no tiene ningún efecto.

Solo para el personal, no se pueden conceder

statistics_get, ai_models_manage, invite_codes_get, invite_codes_manage e invite_codes_delete están reservados al personal de StickyPrompts. No aparecen en la lista de permisos, y una petición para asignarlos a una clave se rechaza con 403 {"error":"You are using permissions that are restricted"}. Por eso la herramienta MCP get_usage_statistics nunca aparece con las claves de los clientes. Los administradores pueden consultar el uso del espacio de trabajo en la aplicación, en Uso, créditos y facturación.

Conjuntos de permisos recomendados

Parte de uno de estos conjuntos y añade solo lo que tu integración acabe necesitando.

Bot de informes de solo lectura

Responde preguntas a partir de una base de datos y de tus documentos, sin escribir nada de vuelta.

Permisos	Para qué
ai_models_get, custom_run	Elegir un modelo y resumir los resultados.
integration_database_get	Encontrar la conexión y leer el esquema.
integration_database_manage	Necesario para ejecutar cualquier consulta. Conecta la base de datos como Read only para que solo se acepten sentencias SELECT.
knowledge_bases_get	Buscar contexto en los documentos.

Chatbot

Un front end (por ejemplo, un bot interno de Slack) que habla con tus agentes y tu conocimiento.

Permisos	Para qué
ai_models_get	Elegir el modelo de las nuevas conversaciones.
conversations_manage, conversations_get	Iniciar conversaciones, enviar mensajes y leer las respuestas.
agents_get	Encontrar agentes para mencionarlos (@mention) o chatear con ellos.
knowledge_bases_get	Pasar bases de conocimiento a una conversación.

Generador de contenido

Rellena tus prompts guardados y genera textos e imágenes.

Permisos	Para qué
ai_models_get	Elegir un modelo.
prompts_get, run_prompt	Encontrar prompts guardados y ejecutarlos con variables.
custom_run	Generaciones puntuales sin un prompt guardado.
image_generation_manage, files_get	Generar imágenes y consultar los archivos resultantes.

Asistente de CRM

Consulta contactos y tratos, mantiene el CRM al día y envía mensajes de seguimiento.

Permisos	Para qué
integration_crm_get	Buscar y listar contactos y tratos.
integration_crm_manage	Añadir y editar contactos y crear tratos. La conexión del CRM debe tener activado Allow write access.
integration_email_get, integration_email_manage	Encontrar la conexión de correo electrónico y enviar el seguimiento.
ai_models_get, custom_run	Redactar el texto del correo.

Páginas relacionadas