Los 15 scopes para claves de API y conexiones de IA: qué permite cada uno, cómo se llama en el panel y qué no puede hacer ninguna clave de API.
Los scopes definen lo que puede hacer una clave de API. Los mismos 15 scopes se aplican también a los asistentes de IA que conectas mediante MCP. Elige siempre solo los scopes que una aplicación necesita de verdad.
Reglas básicas
- Cada endpoint requiere exactamente un scope
- En las claves de API, write:X incluye automáticamente read:X; el panel lo indica con «write:X incluye automáticamente read:X»
- Si falta el scope, la API responde con 403 insufficient_scope e indica el scope necesario en details.required_scope
- Los endpoints que no están habilitados en absoluto para claves de API también responden con 403 insufficient_scope
- Las funciones de propietario y admin, como miembros, facturación o gestión de dominios, no son accesibles con ningún scope
Todos los scopes
En el diálogo «Crear nueva clave de API» eliges «Lectura» o «Escritura» para cada área; la lista de claves muestra los nombres de scope de la primera columna. La forma «Lectura · Páginas» aparece en la página de consentimiento de las apps de IA y en «Apps conectadas».
| Scope | Para apps de IA | Permite |
|---|---|---|
| read:pages | Lectura · Páginas | Listar y leer páginas, leer y validar el borrador, listar bloques, leer el SEO, listar versiones, obtener los tipos de bloque |
| write:pages | Escritura · Páginas | Crear y editar páginas (incluido el handle), editar el borrador, crear, editar, eliminar y reordenar bloques, editar el SEO, visibilidad, publicación, restaurar una versión, enlaces de invitación para páginas privadas |
| read:links | Lectura · Enlaces | Listar y leer los enlaces de una página |
| write:links | Escritura · Enlaces | Crear, editar, eliminar y reordenar enlaces |
| read:assets | Lectura · Recursos | Listar recursos |
| write:assets | Escritura · Recursos | Subir y eliminar recursos, subidas para una página |
| read:forms | Lectura · Formularios | Leer formularios y su resumen, listar envíos y exportarlos como CSV (exportación desde Creator Pro) |
| write:forms | Escritura · Formularios | Crear, editar y eliminar formularios |
| read:stats | Lectura · Estadísticas | Estadísticas de página y de espacio de trabajo (resumen, serie temporal, comparación, enlaces, widgets, conversiones, páginas principales), historial y uso de push |
| read:workspaces | Lectura · Espacios de trabajo | Leer funciones del plan, uso, lista de miembros y ajustes del espacio de trabajo, listar dominios, listar y leer plantillas, listar y leer secretos de callback (sin el secreto en texto plano) |
| write:workspaces | Escritura · Espacios de trabajo | Por ahora ningún endpoint más allá de read:workspaces |
| read:donations | Lectura · Pagos de mecenas | Totales de los pagos de mecenas del espacio de trabajo (pagos mediante el bloque «Apoyar») |
| read:short_links | Lectura · Enlaces cortos | Listar y leer enlaces cortos |
| write:short_links | Escritura · Enlaces cortos | Crear, editar y eliminar enlaces cortos |
| write:templates | Escritura · Plantillas del espacio de trabajo | Crear, editar y eliminar tus propias plantillas del espacio de trabajo (se leen con read:workspaces), consulta Plantillas propias |
Qué endpoints pertenecen exactamente a cada scope se muestra en Endpoints por área.
Lo que ninguna clave de API puede hacer
- Eliminar páginas
- Crear enlaces de vista previa del borrador
- Desgloses de estadísticas por dispositivo, país, referente y UTM
- Enviar notificaciones push y gestionar reglas push
- Conectar o desconectar integraciones
- Gestionar webhooks
- Añadir, verificar, activar, desactivar o eliminar dominios
- Gestionar miembros, invitaciones y roles, transferir la propiedad
- Cambiar los ajustes del espacio de trabajo y la facturación
- Crear, editar, rotar o eliminar secretos de callback
- La lista de pagos de mecenas, las solicitudes de acceso a datos y la anonimización de envíos de formularios
- Gestionar tu perfil, las páginas que sigues y las propias claves de API
Todo esto lo haces en el panel.
Scopes para asistentes de IA
Para una conexión MCP eliges los mismos scopes en la página de consentimiento. Hay dos diferencias: primero, allí un permiso de escritura no incluye el de lectura, así que concede ambos. Segundo, tu rol limita la elección: los visualizadores solo obtienen permisos de lectura (sin formularios ni enlaces cortos), y los editores, todo excepto «Escritura · Espacios de trabajo», los enlaces cortos y las plantillas del espacio de trabajo. Más en Permisos, seguridad y límites.
Combinaciones recomendadas
| Caso de uso | Scopes |
|---|---|
| Informes y cuadros de mando | read:stats, read:pages |
| Sincronizar enlaces desde un CMS o una tienda | write:links, read:pages |
| Mantener y publicar páginas automáticamente | write:pages, write:links |
| Enlaces de campaña desde el CRM | write:short_links |
| Pasar los leads de formularios al CRM | read:forms |
| Desplegar plantillas desde un pipeline de CI | write:templates, read:workspaces |
También te puede ser útil
¿No has encontrado nada?
Cuéntanos qué necesitas y nuestro equipo de soporte te ayudará personalmente.