Tres superficies HTTP: la API del editor que hay detrás de la app, los endpoints de cada sitio publicado y el endpoint MCP para agentes.
API del editor
La app web hace de proxy de /api/** hacia el Worker api. Las solicitudes usan la cookie de sesión HTTP-only y una comprobación CSRF; cada ruta comprueba el rol de quien llama en el sitio. Un sitio en el que no tienes rol responde 404, igual que uno que no existe, así que los ids nunca se filtran. Los límites del plan responden 402 plan_limit.
Autenticación
| Método | Ruta | Propósito |
|---|---|---|
POST | /auth/signup | Crear una cuenta de editor |
POST | /auth/login | Iniciar una sesión (con límite de frecuencia por IP y por correo) |
POST | /auth/logout | Cerrar la sesión |
GET | /auth/me | El usuario que inició sesión |
GET | /auth/realtime-token | Token de corta duración para las salas de un sitio |
POST | /auth/password-reset/request · /confirm | Restablecer una contraseña (responde 501 hasta que se conecte el envío de correos) |
POST | /auth/verify-email/request · /confirm | Verificar la dirección de correo (responde 501 hasta que se conecte el envío de correos) |
POST | /auth/invites · /invites/accept | Invitar a un espacio de trabajo y unirse a él (responde 501 hasta que se conecte el envío de correos) |
Sitios y páginas
| Método | Ruta | Propósito |
|---|---|---|
GET POST | /sites | Listar o crear sitios |
GET PATCH DELETE | /sites/:siteId | Leer, renombrar (slug: administrador) o eliminar un sitio |
GET POST | /sites/:siteId/pages | Listar o crear páginas |
GET PATCH DELETE | /pages/:pageId | Leer, actualizar o eliminar una página |
PUT | /pages/:pageId/doc | Reemplazar el documento de una página |
GET POST | /sites/:siteId/members | Miembros del sitio |
GET POST | /sites/:siteId/assets | Listar o subir recursos |
POST | /sites/:siteId/publish | Publicar en staging (editor) o en producción (administrador) |
GET | /sites/:siteId/publishes?environment= | Publicaciones recientes de staging o production, de la más nueva a la más antigua, con la que está en vivo y quién publicó o revirtió (editor; emails solo para administradores) |
POST | /sites/:siteId/rollback | Revertir un entorno a una de sus publicaciones recientes, { environment, publishId }: staging (editor) o producción (administrador) |
POST | /sites/:siteId/export | ZIP de exportación estática (administrador) |
CMS y formularios
| Método | Ruta | Propósito |
|---|---|---|
GET POST | /sites/:siteId/collections | Colecciones |
GET POST | /sites/:siteId/collections/:id/items | Ítems |
POST | …/items/:itemId/publish · unpublish · archive | Ciclo de vida del ítem |
GET | …/items/:itemId/versions | Versiones del ítem, con …/:versionId/restore |
GET | /sites/:siteId/forms/:formId/submissions(.csv) | Envíos, en JSON o CSV |
Datos y lógica
| Método | Ruta | Propósito |
|---|---|---|
GET POST PATCH DELETE | /sites/:siteId/integrations | Integraciones (escritura: administrador) |
POST | /sites/:siteId/integrations/:id/test | Probar una conexión |
POST | /sites/:siteId/run | Ejecutar una consulta u operación desde el editor |
GET POST PUT DELETE | /sites/:siteId/workflows | Flujos de trabajo de servidor |
POST | /sites/:siteId/workflows/:id/test | Ejecución de prueba (se transmite por …/runs/:runId/stream) |
GET POST PATCH DELETE | /sites/:siteId/tables | Tablas nativas y …/rows |
GET PATCH DELETE | /sites/:siteId/visitors | Visitantes, y …/visitor-roles |
Plataforma
| Método | Ruta | Propósito |
|---|---|---|
GET POST DELETE | /sites/:siteId/domains | Dominios personalizados; …/:id/refresh para volver a comprobar |
GET | /billing/plans | Planes y límites |
PUT | /billing/workspaces/:id/plan · /sites/:siteId/billing/plan | Cambiar un plan (Stripe Checkout) |
GET POST | /catalog/templates | Plantillas; …/:id/use para empezar un sitio |
GET POST | /catalog/plugins | Catálogo de plugins; se instalan por sitio en /sites/:siteId/plugins |
POST | /sites/:siteId/ai | Edición con IA (server-sent events) |
POST | /sites/:siteId/ai/expression | Asistente de expresiones: escribe, corrige o explica una expresión (server-sent events) |
GET | /workspaces/:workspaceId/ai/usage | Gasto de IA de un mes: tokens, costo estimado, cuota, por sitio y tarea (por miembro para administradores) |
GET | /workspaces/:workspaceId/ai/runs | Solicitudes de IA de un mes, de la más reciente a la más antigua, con tokens y costo estimado |
GET POST DELETE | /workspaces/:id/api-keys | Claves de API del espacio de trabajo para MCP |
Sitios publicados
http
# Published sites (any domain of the site)
POST /api/_forms/:formId form submission (Turnstile token required)
POST /api/_q/:name client query of a page
ALL /api/<your path> your server workflow endpoints and webhooks
POST /_auth/signup | login | logout | magic-link
GET /_auth/magic?token=… completes a magic link
GET /_auth/me the current visitor
Los formularios y las consultas tienen límite de frecuencia por IP. Las consultas de una página con una regla de acceso pasan por la misma regla.
MCP
POST /mcp habla JSON-RPC (MCP streamable HTTP) con una clave de API del espacio de trabajo como bearer token. GET /mcp responde 405: no hay un stream iniciado por el servidor.
bash
curl -X POST https://<mcp host>/mcp \
-H 'Authorization: Bearer mk_…' \
-H 'content-type: application/json' \
-d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'