Trois surfaces HTTP : l'API de l'éditeur derrière l'application, les points de terminaison de chaque site publié, et le point de terminaison MCP pour les agents.
API de l'éditeur
L'application web relaie /api/** vers le Worker api. Les requêtes utilisent le cookie de session HTTP-only et une vérification CSRF ; chaque route vérifie le rôle de l'appelant sur le site. Un site sur lequel vous n'avez aucun rôle répond 404, exactement comme un site qui n'existe pas : les ids ne fuient donc jamais. Les limites de forfait répondent 402 plan_limit.
Authentification
| Méthode | Chemin | Rôle |
|---|---|---|
POST | /auth/signup | Créer un compte éditeur |
POST | /auth/login | Ouvrir une session (débit limité par IP et par e-mail) |
POST | /auth/logout | Fermer la session |
GET | /auth/me | L'utilisateur connecté |
GET | /auth/realtime-token | Jeton de courte durée pour les salles d'un site |
POST | /auth/password-reset/request · /confirm | Réinitialiser un mot de passe (répond 501 tant que l'envoi d'e-mails n'est pas branché) |
POST | /auth/verify-email/request · /confirm | Vérifier l'adresse e-mail (répond 501 tant que l'envoi d'e-mails n'est pas branché) |
POST | /auth/invites · /invites/accept | Inviter dans un espace de travail et le rejoindre (répond 501 tant que l'envoi d'e-mails n'est pas branché) |
Sites et pages
| Méthode | Chemin | Rôle |
|---|---|---|
GET POST | /sites | Lister ou créer des sites |
GET PATCH DELETE | /sites/:siteId | Lire, renommer (slug : administrateur) ou supprimer un site |
GET POST | /sites/:siteId/pages | Lister ou créer des pages |
GET PATCH DELETE | /pages/:pageId | Lire, mettre à jour ou supprimer une page |
PUT | /pages/:pageId/doc | Remplacer le document d'une page |
GET POST | /sites/:siteId/members | Membres du site |
GET POST | /sites/:siteId/assets | Lister ou téléverser des ressources |
POST | /sites/:siteId/publish | Publier en préproduction (éditeur) ou en production (administrateur) |
GET | /sites/:siteId/publishes?environment= | Publications récentes de staging ou production, de la plus récente à la plus ancienne, avec celle en ligne et qui a publié ou fait le retour arrière (éditeur ; e-mails pour les administrateurs uniquement) |
POST | /sites/:siteId/rollback | Ramener un environnement à l'une de ses publications récentes, { environment, publishId } : préproduction (éditeur) ou production (administrateur) |
POST | /sites/:siteId/export | ZIP d'export statique (administrateur) |
CMS et formulaires
| Méthode | Chemin | Rôle |
|---|---|---|
GET POST | /sites/:siteId/collections | Collections |
GET POST | /sites/:siteId/collections/:id/items | Éléments |
POST | …/items/:itemId/publish · unpublish · archive | Cycle de vie d'un élément |
GET | …/items/:itemId/versions | Versions d'un élément, avec …/:versionId/restore |
GET | /sites/:siteId/forms/:formId/submissions(.csv) | Soumissions, en JSON ou CSV |
Données et logique
| Méthode | Chemin | Rôle |
|---|---|---|
GET POST PATCH DELETE | /sites/:siteId/integrations | Intégrations (écriture : administrateur) |
POST | /sites/:siteId/integrations/:id/test | Tester une connexion |
POST | /sites/:siteId/run | Exécuter une requête ou une opération depuis l'éditeur |
GET POST PUT DELETE | /sites/:siteId/workflows | Workflows serveur |
POST | /sites/:siteId/workflows/:id/test | Exécution de test (diffusée via …/runs/:runId/stream) |
GET POST PATCH DELETE | /sites/:siteId/tables | Tables natives et …/rows |
GET PATCH DELETE | /sites/:siteId/visitors | Visiteurs, et …/visitor-roles |
Plateforme
| Méthode | Chemin | Rôle |
|---|---|---|
GET POST DELETE | /sites/:siteId/domains | Domaines personnalisés, …/:id/refresh pour revérifier |
GET | /billing/plans | Forfaits et limites |
PUT | /billing/workspaces/:id/plan · /sites/:siteId/billing/plan | Changer de forfait (Stripe Checkout) |
GET POST | /catalog/templates | Modèles, …/:id/use pour démarrer un site |
GET POST | /catalog/plugins | Catalogue de plugins ; installation par site via /sites/:siteId/plugins |
POST | /sites/:siteId/ai | Modification par l'IA (server-sent events) |
POST | /sites/:siteId/ai/expression | Assistant d'expressions : écrit, corrige ou explique une expression (server-sent events) |
GET | /workspaces/:workspaceId/ai/usage | Dépenses IA d'un mois : tokens, coût estimé, quota, par site et par tâche (par membre pour les administrateurs) |
GET | /workspaces/:workspaceId/ai/runs | Requêtes IA d'un mois, de la plus récente à la plus ancienne, avec tokens et coût estimé |
GET POST DELETE | /workspaces/:id/api-keys | Clés d'API de l'espace de travail pour MCP |
Sites publiés
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
Les formulaires et les requêtes ont un débit limité par IP. Les requêtes d'une page soumise à une règle d'accès passent par la même règle.
MCP
POST /mcp parle JSON-RPC (MCP streamable HTTP), avec une clé d'API de l'espace de travail comme jeton bearer. GET /mcp répond 405 : il n'existe pas de flux initié par le serveur.
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" }'