API HTTP

Liste des routes HTTP exposées par le serveur Fastify d’arka-deck, groupées par domaine fonctionnel.

Source de vérité : adapters/inbound/web/server/src/routes/.

---

Middleware global

• CORS : localhost + plages RFC1918 en mode LAN
• CSP : script-src 'self', connect-src localhost + LAN
• Rate limit : 900 writes/min (exemptions GET/loopback)
• Token : header X-Arka-Token obligatoire en mode LAN
• HSTS : désactivé (HTTP local, pas TLS)
• Request ID : UUID par requête, loggé

---

Système

Méthode	Path	Description
GET	/api/health	Health check (statut + version)
GET	/api/system/*	Métadonnées système (boot, token)
GET	/api/i18n/:lang	Traductions UI
GET	/api/preferences	Préférences utilisateur
PUT	/api/preferences	Mettre à jour les préférences

---

Workspaces et projets

Méthode	Path	Description
GET	/api/workspaces	Liste
GET	/api/workspaces/:id	Détail
POST	/api/workspaces	Créer
PUT	/api/workspaces/:id	Modifier
DELETE	/api/workspaces/:id	Supprimer (refuse si non-vide)
GET	/api/workspaces/:id/projects	Projets du workspace
GET	/api/projects	Liste tous projets
GET	/api/projects/:id	Détail
GET	/api/projects/find-by-cwd?path=...	Détection auto par marker
POST	/api/projects	Créer (vérifie allowlist + workspace)
PUT	/api/projects/:id	Modifier (path immuable)
DELETE	/api/projects/:id	Forget (204)
DELETE	/api/projects/:id?purge=true	Purge complet
POST	/api/projects/:id/touch	Mettre à jour lastUsedAt

---

Catalogue Cortex

Méthode	Path	Description
GET	/api/catalogue/profiles	Liste des profils HYOS
GET	/api/catalogue/profiles/:id	Détail d’un profil
DELETE	/api/catalogue/cache	Vider le cache catalogue

---

Chat et sessions

Méthode	Path	Description
POST	/api/chat/sessions	Démarrer une session
POST	/api/chat/sessions/:id/send-message	Envoyer un tour (SSE stream)
GET	/api/chat/sessions/:id/stream	Stream SSE de la session
GET	/api/chat/sessions	Lister les sessions d’un projet
GET	/api/chat/sessions/:id	Détail session

---

Mémoire

Méthode	Path	Description
GET	/api/memory/:projectId	Vue d’ensemble mémoire projet
POST	/api/memory/:projectId/entry	Capturer une entrée
GET	/api/memory/:projectId/entries	Lister les entrées

---

ArkaDoc

Méthode	Path	Description
GET	/api/arkadoc/:projectId	Liste documents
GET	/api/arkadoc/:projectId/:docId	Détail document
PATCH	/api/arkadoc/:projectId/:docId/status	Modifier statut
GET	/api/arkadoc/:projectId/:docId/render	Rendu Markdown

---

Agent action cards & Cortex Actions

Méthode	Path	Description
GET	/api/agent-action-cards/:projectId	Cartes pour le projet
POST	/api/agent-action-cards/:projectId/select	Sélectionner une carte avant tour
GET	/api/cortex-actions/tree	Arbre Cortex (modes, blocs)
GET	/api/cortex-actions/search	Recherche
POST	/api/cortex-actions/select	Enregistrer sélection
GET	/api/cortex-actions/favorites	Favoris projet
POST	/api/cortex-actions/suggest	Lancer le worker de suggestion

---

Squad et orchestration

Méthode	Path	Description
GET	/api/squads/:projectId	Liste squads du projet
POST	/api/squads	Créer une squad
POST	/api/squads/:id/materialize-leader	Recruter le Pack Leader
GET	/api/orchestration/:projectId/missions	Liste missions
POST	/api/orchestration/missions	Démarrer mission
GET	/api/orchestration/missions/:id	État mission

---

Mission Guardian

Méthode	Path	Description
GET	/api/mission-guardian/:projectId/state	État phases + gates
POST	/api/mission-guardian/:projectId/decision	Enregistrer décision
GET	/api/mission-guardian/:projectId/evidence	Preuves capturées

---

Gouvernance Lite

Méthode	Path	Description
GET	/api/governance-lite/:projectId/policy	Policy active
POST	/api/governance-lite/:projectId/policy	Sauvegarder une policy
GET	/api/governance-lite/:projectId/followup	Followup

---

Providers et runtimes

Méthode	Path	Description
GET	/api/providers/manifests	Manifests statiques (catalogue)
GET	/api/providers/instances	Liste instances configurées
POST	/api/providers/instances	Créer une instance
PUT	/api/providers/instances/:id	Modifier
DELETE	/api/providers/instances/:id	Supprimer
POST	/api/providers/instances/:id/test	Tester (check + live)
GET	/api/cortex-lite/projects/:id/state	État Cortex Lite projet
POST	/api/cortex-lite/projects/:id/sync	Synchroniser

---

Connecteurs

Méthode	Path	Description
GET	/api/connectors/manifests	Connecteurs disponibles
GET	/api/connectors/installations/:projectId	Installations du projet
POST	/api/connectors/installations	Activer un connecteur
DELETE	/api/connectors/installations/:id	Désactiver
POST	/api/connectors/oauth/start	Démarrer flow OAuth
GET	/api/connectors/oauth/callback	Callback OAuth
POST	/api/connectors/executions	Exécuter une action
GET	/api/connectors/audit-log/:projectId	Audit trail

---

Workers

Méthode	Path	Description
POST	/api/workers/:name/invoke	Invoquer un worker (1-shot)
GET	/api/workers/:name/logs	Logs d’invocation

---

Filesystem (allowlist)

Méthode	Path	Description
GET	/api/fs/read?path=...	Lire un fichier
POST	/api/fs/write	Écrire (allowlist)

---

Voir aussi

• CLI : ./cli
• Variables d’environnement : ./variables-env
• Politique URL runtime : ../architecture/stockage, ADR 0006