Référence d'API

Fichier produit par scripts/generate_api_reference.py (vague C8) et gardé en CI (tests/test_api_reference.py). Après tout ajout/changement de route : venv/bin/python scripts/generate_api_reference.py puis committer le diff.

Contrat scriptable : les routes marquées ⭐ (__api_stable__) forment le parcours upload → process → status → download que les auto-hébergeurs peuvent scripter — c'est un contrat ; le reste est interne et peut bouger.

Authentification des routes ⭐ : cookie de session (login) OU jeton d'API personnel Authorization: Bearer tia_… (page « Mon compte → Jetons d'API »). Le jeton porte les permissions de son propriétaire, v1 limité aux routes ⭐ — la création du job reste en session. Cf. docs/GESTION_IDENTITE.md §3.8.

Portail TranscrIA (app principale)

Blueprint (app)

Route	Méthodes	Auth	Description	Module
/i18n/messages.js	GET	—	Catalogue JS : window.I18N = { source_fr: traduction } pour la locale courante.	transcria.web.i18n

Blueprint audit

Route	Méthodes	Auth	Description	Module
/admin/audit	GET	connexion + Permission.ACCESS_SYSTEM	(docstring manquante)	transcria.audit.routes
/admin/audit/export.csv	GET	connexion + Permission.ACCESS_SYSTEM	(docstring manquante)	transcria.audit.routes

Blueprint auth

Route	Méthodes	Auth	Description	Module
/account/password	GET,POST	connexion requise	(docstring manquante)	transcria.auth.routes
/account/tokens	GET,POST	connexion requise	Chantier identité lot 4 : jetons d'API personnels (« Mon compte »).	transcria.auth.routes
/account/tokens/<token_id>/revoke	POST	connexion requise	Révoque un de MES jetons (soft : revoked_at posé, la trace d'audit reste).	transcria.auth.routes
/admin/groups	GET	connexion requise	(docstring manquante)	transcria.auth.routes
/admin/groups/<group_id>/edit	GET,POST	connexion requise	(docstring manquante)	transcria.auth.routes
/admin/groups/new	GET,POST	connexion + Permission.MANAGE_USERS	(docstring manquante)	transcria.auth.routes
/admin/users	GET	connexion + Permission.MANAGE_USERS	(docstring manquante)	transcria.auth.routes
/admin/users/<user_id>/edit	GET,POST	connexion + Permission.MANAGE_USERS	(docstring manquante)	transcria.auth.routes
/admin/users/new	GET,POST	connexion + Permission.MANAGE_USERS	(docstring manquante)	transcria.auth.routes
/auth/oidc/callback	GET	—	Retour de l'IdP : validation complète, JIT, session — ou refus audité.	transcria.auth.routes
/auth/oidc/login	GET	—	Chantier identité lot 1 : départ du flux Authorization Code + PKCE.	transcria.auth.routes
/auth/proxy/login	GET	—	Chantier identité lot 3 : connexion par en-têtes de proxy de confiance.	transcria.auth.routes
/login	GET,POST	—	(docstring manquante)	transcria.auth.routes
/logout	POST	connexion requise	(docstring manquante)	transcria.auth.routes

Blueprint central_lexicon

Route	Méthodes	Auth	Description	Module
/admin/lexicons	GET	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>	GET	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>/delete	POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>/entries	POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>/entries/<entry_id>	POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>/entries/<entry_id>/delete	POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>/export.csv	POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>/import	POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/<lexicon_id>/metadata	POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes
/admin/lexicons/new	GET,POST	connexion requise	(docstring manquante)	transcria.context.central_lexicon_routes

Blueprint meeting_types

Route	Méthodes	Auth	Description	Module
/api/meeting-types	GET	connexion requise	Catalogue de l'utilisateur courant : intégrés + personnalisés visibles.	transcria.context.meeting_type_routes
/api/meeting-types	POST	connexion requise	(docstring manquante)	transcria.context.meeting_type_routes
/api/meeting-types/<template_id>	DELETE	connexion requise	(docstring manquante)	transcria.context.meeting_type_routes
/api/meeting-types/<template_id>	PUT	connexion requise	(docstring manquante)	transcria.context.meeting_type_routes
/api/meeting-types/<template_id>/export	GET	connexion requise	Fichier d'échange du type (schéma du catalogue, SANS branding) — §8.	transcria.context.meeting_type_routes
/api/meeting-types/<template_id>/logo	DELETE,POST	connexion requise	Logo du type — branding LOCAL (re-encodé, jamais exporté ni importé).	transcria.context.meeting_type_routes
/api/meeting-types/<template_id>/preview.docx	GET	connexion requise	Aperçu d'un type ENREGISTRÉ (avec son logo) — visible de l'utilisateur requis.	transcria.context.meeting_type_routes
/api/meeting-types/<template_id>/scope	POST	connexion requise	(docstring manquante)	transcria.context.meeting_type_routes
/api/meeting-types/import	POST	connexion requise	Import d'un fichier d'échange → type PRIVÉ, INACTIF (à relire) — §8.2.	transcria.context.meeting_type_routes
/api/meeting-types/preview.docx	POST	connexion requise	Aperçu AVANT enregistrement : la définition en cours d'édition → DOCX d'exemple.	transcria.context.meeting_type_routes
/meeting-types	GET	connexion requise	Page « Mes types de réunion » — galerie + éditeur (lot E).	transcria.context.meeting_type_routes

Blueprint queue_api

Route	Méthodes	Auth	Description	Module
/api/queue/<job_id>/cancel	POST	connexion requise	(docstring manquante)	transcria.queue.routes
/api/queue/<job_id>/move-down	POST	connexion requise	(docstring manquante)	transcria.queue.routes
/api/queue/<job_id>/move-up	POST	connexion requise	(docstring manquante)	transcria.queue.routes
/api/queue/<job_id>/pause	POST	connexion requise	(docstring manquante)	transcria.queue.routes
/api/queue/<job_id>/priority	POST	connexion requise	(docstring manquante)	transcria.queue.routes
/api/queue/<job_id>/resume	POST	connexion requise	(docstring manquante)	transcria.queue.routes
/api/queue/e2e-test-jobs/purge	POST	connexion requise	(docstring manquante)	transcria.queue.routes
/api/queue/status	GET	connexion requise	(docstring manquante)	transcria.queue.routes
/api/schedule/enabled	POST	connexion + Permission.MANAGE_SCHEDULE	Activer/désactiver l'AGENDA ENTIER depuis la page (constat audit C3.6 : on	transcria.queue.routes
/api/schedule/windows	GET	connexion + Permission.MANAGE_SCHEDULE	(docstring manquante)	transcria.queue.routes
/api/schedule/windows	POST	connexion + Permission.MANAGE_SCHEDULE	(docstring manquante)	transcria.queue.routes
/api/schedule/windows/<int:window_id>	DELETE	connexion + Permission.MANAGE_SCHEDULE	(docstring manquante)	transcria.queue.routes
/api/schedule/windows/<int:window_id>	PUT	connexion + Permission.MANAGE_SCHEDULE	(docstring manquante)	transcria.queue.routes

Blueprint queue_pages

Route	Méthodes	Auth	Description	Module
/admin/queue	GET	connexion requise	(docstring manquante)	transcria.queue.routes
/admin/schedule	GET	connexion + Permission.MANAGE_SCHEDULE	(docstring manquante)	transcria.queue.routes

Blueprint srt_editor

Route	Méthodes	Auth	Description	Module
/api/jobs/<job_id>/audio/stream	GET	connexion requise	(docstring manquante)	transcria.web.editor_routes
/api/jobs/<job_id>/editor/draft	DELETE	connexion requise	(docstring manquante)	transcria.web.editor_routes
/api/jobs/<job_id>/editor/draft	GET	connexion requise	Contenu du brouillon (écran « Reprendre où vous en étiez »).	transcria.web.editor_routes
/api/jobs/<job_id>/editor/draft	PUT	connexion requise	(docstring manquante)	transcria.web.editor_routes
/api/jobs/<job_id>/editor/peaks	GET	connexion requise	(docstring manquante)	transcria.web.editor_routes
/api/jobs/<job_id>/editor/save	POST	connexion requise	(docstring manquante)	transcria.web.editor_routes
/api/jobs/<job_id>/editor/state	GET	connexion requise	(docstring manquante)	transcria.web.editor_routes
/api/jobs/<job_id>/editor/sync-summary	POST	connexion requise	Enfile la passe LLM « synthèse mise à jour depuis le SRT corrigé ».	transcria.web.editor_routes
/jobs/<job_id>/editor	GET	connexion requise	(docstring manquante)	transcria.web.editor_routes

Blueprint voice

Route	Méthodes	Auth	Description	Module
/admin/voices	GET	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/<subject_id>	GET	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/<subject_id>/consent-proof/<consent_id>	GET	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/<subject_id>/consents	POST	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/<subject_id>/disable	POST	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/<subject_id>/generate	POST	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/<subject_id>/metadata	POST	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/consent-form.pdf	GET	connexion requise	(docstring manquante)	transcria.voice.routes
/admin/voices/new	GET,POST	connexion requise	(docstring manquante)	transcria.voice.routes

Blueprint web

Route	Méthodes	Auth	Description	Module
/	GET	connexion requise	(docstring manquante)	transcria.web.pages_routes
/admin/config	GET,POST	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/connecteurs	GET	connexion + Permission.MANAGE_CONFIG	Connecteurs de réunion : check-list vivante, activation en UN clic, exécutants.	transcria.web.admin_routes
/admin/connecteurs/<connector_id>/credentials	POST	connexion + Permission.MANAGE_CONFIG	Identités de PLATEFORME saisies par l'interface (« l'admin ne touche que	transcria.web.admin_routes
/admin/connecteurs/<connector_id>/test	POST	connexion + Permission.MANAGE_CONFIG	Bouton « Tester la connexion » — vérifie les identités contre l'AUTHENTIFICATION	transcria.web.admin_routes
/admin/connecteurs/meet/spaces	POST	connexion + Permission.MANAGE_CONFIG	Réunions Meet à surveiller — ajout/retrait depuis l'interface.	transcria.web.admin_routes
/admin/connecteurs/meetings/toggle	POST	connexion + Permission.MANAGE_CONFIG	Interrupteur UNIQUE des réunions en ligne — active = auto-provisionnement complet	transcria.web.admin_routes
/admin/connecteurs/runners/<name>/revoke	POST	connexion + Permission.MANAGE_CONFIG	Révoque PRÉCISÉMENT cet exécutant (son jeton du heartbeat) — son prochain battement	transcria.web.admin_routes
/admin/connecteurs/runners/kit	POST	connexion + Permission.MANAGE_CONFIG	Génère le kit « exécutant distant » (docs/RUNNER_DISTANT_KIT.md) : un script	transcria.web.admin_routes
/admin/connecteurs/zoom-sdk/test-legacy	POST	connexion + Permission.MANAGE_CONFIG	Bouton « Tester la connexion » de la fiche Zoom : vérifie le couple Client	transcria.web.admin_routes
/admin/first-run-status	GET	connexion + Permission.MANAGE_CONFIG	Fragment HTML de la checklist de premier démarrage (204 quand tout est vert).	transcria.web.admin_routes
/admin/hardware	GET,POST	connexion + Permission.MANAGE_CONFIG	Préconisations matériel (lot conseiller) : scan GPU vs config courante.	transcria.web.admin_routes
/admin/maintenance	GET	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/maintenance/backup	POST	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/maintenance/backup/<name>/download	GET	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/maintenance/restore	POST	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/maintenance/schedule	POST	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/maintenance/update-check	POST	connexion + Permission.MANAGE_CONFIG	Vérification MANUELLE (toujours disponible, indépendante de l'opt-in) :	transcria.web.admin_routes
/admin/maintenance/upgrade	POST	connexion + Permission.MANAGE_CONFIG	Mise à niveau outillée depuis l'UI (bare-metal systemd uniquement).	transcria.web.admin_routes
/admin/maintenance/upgrade/status	GET	connexion + Permission.MANAGE_CONFIG	Progression de la mise à niveau (sondée par la page — lecture du fichier d'état).	transcria.web.admin_routes
/admin/models	GET	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/models/activate	POST	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/models/download	POST	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/admin/models/ollama-activate	POST	connexion + Permission.MANAGE_CONFIG	Bascule le modèle Ollama servi — symétrique du « Activer (servir) » des GGUF.	transcria.web.admin_routes
/admin/models/progress/<role>	GET	connexion + Permission.MANAGE_CONFIG	(docstring manquante)	transcria.web.admin_routes
/api/jobs/<job_id>/analyze	POST	connexion requise	(docstring manquante)	transcria.web.wizard_api
/api/jobs/<job_id>/audio/excerpt	GET	connexion requise	(docstring manquante)	transcria.web.downloads_api
/api/jobs/<job_id>/available-lexicons	GET	connexion requise	(docstring manquante)	transcria.web.lexicon_api
/api/jobs/<job_id>/context	POST	connexion requise	(docstring manquante)	transcria.web.wizard_api
/api/jobs/<job_id>/download/audio	GET	connexion requise	(docstring manquante)	transcria.web.downloads_api
⭐ /api/jobs/<job_id>/download/docx	GET	connexion requise	Télécharge le compte rendu Word (DOCX — contrat scriptable).	transcria.web.downloads_api
⭐ /api/jobs/<job_id>/download/package	GET	connexion requise	Télécharge le paquet complet des livrables (ZIP — contrat scriptable).	transcria.web.downloads_api
⭐ /api/jobs/<job_id>/download/srt	GET	connexion requise	Télécharge le sous-titrage corrigé (SRT — contrat scriptable).	transcria.web.downloads_api
/api/jobs/<job_id>/export	POST	connexion requise	(docstring manquante)	transcria.web.processing_api
/api/jobs/<job_id>/lexicon	POST	connexion requise	(docstring manquante)	transcria.web.lexicon_api
/api/jobs/<job_id>/lexicon/debug	GET	connexion requise	Diagnostic lexique pour faciliter le débogage des affichages contextes.	transcria.web.lexicon_api
/api/jobs/<job_id>/lexicon/promote	POST	connexion requise	Étape 6 : pousser une forme validée du lexique de SESSION vers un lexique	transcria.web.lexicon_api
/api/jobs/<job_id>/meeting-invite	POST	connexion requise	Mémorise une invitation de réunion collée (objet, corps, destinataires).	transcria.web.wizard_api
/api/jobs/<job_id>/meeting-invite/document	POST	connexion requise	Joint un document présenté (PDF/DOCX/PPTX/TXT) au contexte du résumé.	transcria.web.wizard_api
/api/jobs/<job_id>/meeting-invite/document/<int:index>	DELETE	connexion requise	Retire un document joint (par position dans la liste).	transcria.web.wizard_api
/api/jobs/<job_id>/participants	POST	connexion requise	(docstring manquante)	transcria.web.wizard_api
⭐ /api/jobs/<job_id>/process	POST	connexion requise	Lance le traitement complet du job (mise en file — contrat scriptable).	transcria.web.processing_api
/api/jobs/<job_id>/profile	POST	connexion requise	Persiste le profil choisi à l'étape 1 (le wizard adapte alors ses étapes au profil).	transcria.web.wizard_api
/api/jobs/<job_id>/quality	POST	connexion requise	(docstring manquante)	transcria.web.processing_api
/api/jobs/<job_id>/refine	POST	connexion requise	(docstring manquante)	transcria.web.refine_api
/api/jobs/<job_id>/refine/chat	GET	connexion requise	Endpoint de polling unique du panneau : tours + busy + versions + options.	transcria.web.refine_api
/api/jobs/<job_id>/refine/render-options	POST	connexion requise	Options de rendu déterministes SANS LLM (thème/sections) — effet immédiat.	transcria.web.refine_api
/api/jobs/<job_id>/refine/revert	POST	connexion requise	Restaure un snapshot pris AVANT une application (retour arrière utilisateur).	transcria.web.refine_api
/api/jobs/<job_id>/reprocess	POST	connexion requise	Relance le traitement d'un job déjà terminé (lexique modifié, prompt mis à jour…).	transcria.web.processing_api
/api/jobs/<job_id>/selected-lexicons	POST	connexion requise	(docstring manquante)	transcria.web.lexicon_api
/api/jobs/<job_id>/speaker-hint	POST	connexion requise	Mémorise la fourchette de locuteurs (min/max) choisie par l'utilisateur.	transcria.web.wizard_api
/api/jobs/<job_id>/speakers/clip/<path:clip_name>	GET	connexion requise	(docstring manquante)	transcria.web.downloads_api
/api/jobs/<job_id>/speakers/clips	GET	connexion requise	(docstring manquante)	transcria.web.downloads_api
/api/jobs/<job_id>/speakers/detect	POST	connexion requise	(docstring manquante)	transcria.web.wizard_api
/api/jobs/<job_id>/speakers/map	POST	connexion requise	(docstring manquante)	transcria.web.wizard_api
/api/jobs/<job_id>/speakers/voice-match	POST	connexion requise	(docstring manquante)	transcria.web.wizard_api
⭐ /api/jobs/<job_id>/status	GET	connexion requise	Endpoint léger de polling — état courant du job pendant le traitement (contrat scriptable).	transcria.web.processing_api
/api/jobs/<job_id>/summary	POST	connexion requise	(docstring manquante)	transcria.web.wizard_api
⭐ /api/jobs/<job_id>/upload	POST	connexion requise	Dépose le fichier audio d'un job fraîchement créé (contrat scriptable).	transcria.web.wizard_api
/api/meetings	POST	connexion requise	Planifie une réunion : crée le JOB (provenance posée) + la session (référence chiffrée),	transcria.web.meetings_api
/api/meetings/<session_id>/cancel	POST	connexion requise	Annule une session (états annulables seulement) — visibilité = celle du job porteur.	transcria.web.meetings_api
/api/meetings/<session_id>/captions	GET	connexion requise	Delta du suivi en direct pour la page du job (?after=<n>) — visibilité = celle du	transcria.web.meetings_api
/api/meetings/<session_id>/reschedule	POST	connexion requise	Relance une captation depuis un état terminal replanifiable : NOUVELLE session, MÊME	transcria.web.meetings_api
/api/meetings/availability	GET	connexion requise	Moteurs prêts + nombre de runners — pilote l'affichage de la carte « Réunion ».	transcria.web.meetings_api
/api/profiles/availability	GET	connexion requise	Profils de traitement disponibles + profil recommandé (source unique pour le wizard).	transcria.web.wizard_api
/api/resources/status	GET	connexion requise	État des ressources distantes pour le panneau frontale (mode dégradé inclus).	transcria.web.processing_api
/api/system/status	GET	connexion + Permission.ACCESS_SYSTEM	(docstring manquante)	transcria.web.processing_api
/health	GET	—	(docstring manquante)	transcria.web.health_routes
/jobs/<job_id>	GET	connexion requise	(docstring manquante)	transcria.web.pages_routes
/jobs/<job_id>/delete	POST	connexion + Permission.DELETE_JOBS	(docstring manquante)	transcria.web.pages_routes
/jobs/<job_id>/result	GET	connexion requise	(docstring manquante)	transcria.web.pages_routes
/jobs/new	POST	connexion + Permission.CREATE_JOBS	(docstring manquante)	transcria.web.pages_routes
/metrics	GET	—	(docstring manquante)	transcria.web.health_routes
/ready	GET	—	(docstring manquante)	transcria.web.health_routes
/system	GET	connexion + Permission.ACCESS_SYSTEM	(docstring manquante)	transcria.web.pages_routes
/v1/audio/ingest	POST	—	Dépôt d'un enregistrement post-réunion → job TranscrIA (pipeline complet).	transcria.web.facade_api
/v1/audio/transcriptions	POST	—	Transcription STT sans état, compatible OpenAI Audio Transcriptions.	transcria.web.facade_api
/v1/meetings/<session_id>/captions	POST	—	Tours de parole PROVISOIRES relayés par lots par le runner claimant (vague 5, D5.5).	transcria.web.meetings_api
/v1/meetings/<session_id>/events	POST	—	Événement de vie relayé par le runner claimant (jamais un terminal) — idempotent,	transcria.web.meetings_api
/v1/meetings/<session_id>/result	POST	—	Issue d'une exécution de bot : mapping des codes 0/1/2/3 par la machine d'états	transcria.web.meetings_api
/v1/meetings/claim	POST	—	Claim atomique (SKIP LOCKED) des sessions dues — SEUL endroit où la référence de	transcria.web.meetings_api
/v1/meetings/meet/watched-users	GET	—	Utilisateurs dont le service Meet doit surveiller les réunions.	transcria.web.meetings_api
/v1/runners/heartbeat	POST	—	Annonce d'un exécutant (capacité, plateformes couvertes, images) — alimente	transcria.web.meetings_api

Portail TranscrIA (app principale) : 154 routes, 92 sans docstring.

Service d'inférence (nœud de ressources)

Blueprint capabilities

Route	Méthodes	Auth	Description	Module
/capabilities	GET	—	(docstring manquante)	inference_service.routes.capabilities

Blueprint diarize

Route	Méthodes	Auth	Description	Module
/infer/diarize	POST	—	(docstring manquante)	inference_service.routes.diarize

Blueprint engines

Route	Méthodes	Auth	Description	Module
/engines/ensure	POST	—	(docstring manquante)	inference_service.routes.engines

Blueprint health

Route	Méthodes	Auth	Description	Module
/health	GET	—	Le process répond — ne charge aucun modèle, toujours 200 si vivant.	inference_service.routes.health
/models	GET	—	Inventaire des modèles servis et leur état (loaded/unloaded, device…).	inference_service.routes.health
/ready	GET	—	Prêt à servir : les moteurs existent et peuvent charger/servent déjà.	inference_service.routes.health

Blueprint transcribe

Route	Méthodes	Auth	Description	Module
/infer/transcribe	POST	—	Transcrit un audio sur le nœud de calcul (référence fichier ou upload multipart).	inference_service.routes.transcribe

Blueprint voice_embed

Route	Méthodes	Auth	Description	Module
/infer/voice-embed	POST	—	(docstring manquante)	inference_service.routes.voice_embed

Service d'inférence (nœud de ressources) : 8 routes, 4 sans docstring.