Ce catalogue contient 141 opérations publiées. Pour explorer les capacités de recherche, consultez les 30 opérations détaillées dans la référence des API de recherche.
La publication est fail-closed : une route OpenAPI nouvelle reste invisible tant qu’un lot de publication ne référence pas une preuve revue. Les schémas et exemples détaillés sont disponibles dans les pages OpenAPI de cette section.
Authentification du panneau de test
Dans API Manager, les tests utilisent votre session utilisateur active et le workspace sélectionné. Depuis un script ou une intégration externe, utilisez une clé API et transmettez
x-workspace-idlorsque le catalogue l’indique.
Agent
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/agent/invoke | Démarre une requête Agent avec le contexte et le mode de restitution demandés. Selon ce mode, l’appel retourne une session à suivre de façon asynchrone ou ouvre un flux SSE afin de recevoir progressivement les événements et résultats. | X-API-Key | agent-contract-v1 |
POST | /api/v1/agent/query | Traite une question en langage naturel, mobilise uniquement les outils autorisés et retourne la réponse une fois la synthèse terminée. Ce mode convient aux traitements courts pour lesquels le client peut attendre la réponse complète dans le même échange HTTP. | X-API-Key | agent-contract-v1 |
GET | /api/v1/agent/sessions | Retourne les sessions Agent récentes accessibles avec la clé API et le contexte courants. Cette liste permet de retrouver des traitements précédents, d’en suivre l’état et d’accéder à leur historique sans révéler les sessions d’un autre périmètre. | X-API-Key | agent-contract-v1 |
DELETE | /api/v1/agent/sessions/{id} | Demande l’arrêt d’une session Agent qui est encore active afin de limiter les traitements et appels d’outils restants. Les événements et résultats déjà produits sont conservés pour l’audit ; une session arrivée à son terme ne peut pas être effacée par cette opération. | X-API-Key | agent-contract-v1 |
GET | /api/v1/agent/sessions/{id}/status | Retourne l’état d’une session Agent, sa progression et les outils déjà exécutés ou en cours d’utilisation. Cette ressource permet à un client asynchrone de suivre le traitement jusqu’à son terme et de présenter une progression explicable. | X-API-Key | agent-contract-v1 |
GET | /api/v1/agent/stats | Agrège les principaux indicateurs d’utilisation de l’agent pour le workspace associé à la requête. Cette vue aide à suivre l’activité et les tendances d’usage sans retourner le contenu individuel des questions, réponses ou sessions. | X-API-Key | agent-contract-v1 |
GET | /api/v1/agent/tools | Liste les outils que l’agent courant est autorisé à employer, avec leur catégorie et leurs paramètres attendus. Le résultat reflète les capacités réellement accessibles dans le contexte de la requête et peut servir à informer une interface ou valider une configuration. | X-API-Key | agent-contract-v1 |
Bundles
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/bundles/{id}/preview | Analyse le bundle ciblé et calcule les ressources qui seraient créées ou rapprochées ainsi que les conflits à résoudre. La prévisualisation aide à décider et préparer l’import tout en garantissant qu’aucune modification n’est appliquée au workspace. | X-API-Key + x-workspace-id | safe-evaluations-and-instance-views-20260804180943 |
Calendrier
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/calendar/calendars | Crée un calendrier dans le workspace à partir de son nom, de sa couleur et de son fuseau horaire. Le calendrier devient ensuite un conteneur distinct pour organiser des événements et interpréter correctement leurs dates dans le fuseau choisi. | X-API-Key + x-workspace-id | calendar-crud-staging-2026-06-12 |
DELETE | /api/v1/calendar/calendars/{id} | Supprime le calendrier ciblé ainsi que les événements qui lui sont rattachés dans le workspace. Le calendrier défini comme calendrier par défaut est protégé et doit d’abord perdre ce rôle avant de pouvoir être supprimé. | X-API-Key + x-workspace-id | calendar-crud-staging-2026-06-12 |
GET | /api/v1/calendar/events | Retourne les événements accessibles en appliquant les filtres de calendrier et de période demandés. Les séries récurrentes sont développées en occurrences sur la fenêtre consultée, ce qui permet d’afficher un agenda exploitable sans reconstituer la récurrence côté client. | X-API-Key + x-workspace-id | calendar-crud-staging-2026-06-12 |
DELETE | /api/v1/calendar/events/{id} | Supprime l’événement identifié du calendrier du workspace. Pour un événement récurrent, l’opération retire la série complète plutôt qu’une occurrence calculée isolément ; le client doit donc confirmer que cette portée correspond bien à l’intention utilisateur. | X-API-Key + x-workspace-id | calendar-crud-staging-2026-06-12 |
GET | /api/v1/calendar/events/{id} | Retourne le détail de l’événement demandé après avoir vérifié qu’il appartient bien au workspace actif. La réponse permet de retrouver ses dates, son calendrier et sa configuration de récurrence éventuelle sans charger toute la période de l’agenda. | X-API-Key + x-workspace-id | calendar-crud-staging-2026-06-12 |
PUT | /api/v1/calendar/events/{id} | Met à jour les informations de l’événement ciblé dans son calendrier. Lorsqu’il appartient à une série récurrente, la modification porte sur la définition de cette série et peut donc affecter les occurrences générées à partir de celle-ci. | X-API-Key + x-workspace-id | calendar-crud-staging-2026-06-12 |
Dashboard
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/custom-dashboards | Liste les tableaux de bord personnalisés accessibles dans le workspace avec les métadonnées nécessaires à leur sélection et à leur affichage. Cette lecture fournit une vue de catalogue sans obliger le client à récupérer séparément la configuration complète de chaque tableau. | X-API-Key + x-workspace-id | dashboard-crud-staging-2026-06-12 |
POST | /api/custom-dashboards | Crée un tableau de bord personnalisable dans le workspace avec son identité et sa mise en page initiale. La ressource retournée constitue le conteneur dans lequel des widgets pourront être organisés pour présenter les indicateurs adaptés au besoin métier. | X-API-Key + x-workspace-id | dashboard-crud-staging-2026-06-12 |
DELETE | /api/custom-dashboards/{id} | Supprime définitivement le tableau de bord personnalisé ciblé et l’ensemble des widgets qui lui sont rattachés. La suppression porte sur la composition de restitution, pas sur les données métier ou sources utilisées par les widgets. | X-API-Key + x-workspace-id | dashboard-crud-staging-2026-06-12 |
GET | /api/custom-dashboards/{id} | Retourne le tableau de bord demandé avec sa mise en page et les widgets qui composent sa restitution. L’accès est limité au workspace actif afin qu’une intégration puisse reconstruire fidèlement la vue sans exposer les configurations d’un autre espace. | X-API-Key + x-workspace-id | dashboard-crud-staging-2026-06-12 |
PUT | /api/custom-dashboards/{id} | Met à jour les informations éditables du tableau de bord, notamment son nom, sa description ou l’organisation de sa mise en page. Cette opération permet d’enregistrer une nouvelle composition tout en conservant l’identité du tableau dans le workspace. | X-API-Key + x-workspace-id | dashboard-crud-staging-2026-06-12 |
POST | /api/custom-dashboards/{id}/duplicate | Crée dans le workspace une nouvelle copie du tableau de bord ciblé, en reproduisant sa mise en page et tous ses widgets. Cette duplication permet de préparer une variante sans modifier l’original ; la copie possède sa propre identité et peut ensuite évoluer indépendamment. | X-API-Key + x-workspace-id | dashboard-observability |
Datapipelines
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/data-pipelines | Retourne les pipelines accessibles dans le workspace avec filtres de statut, de type et pagination. Cette vue de catalogue permet de suivre le portefeuille de traitements, de retrouver un pipeline et d’identifier son état sans charger chaque définition de graphe complète. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id} | Retourne la configuration détaillée du pipeline demandé, sa définition de flux et son état courant dans le workspace. Cette ressource fournit le contexte nécessaire pour l’afficher, l’auditer ou préparer une exécution sans modifier sa version active. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/audit | Retourne la chronologie des changements de configuration et des événements d’exécution audités pour le pipeline. Cette piste permet d’identifier qui a fait évoluer le traitement et de rapprocher une modification d’un comportement observé, sans altérer l’historique. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
POST | /api/v1/data-pipelines/{id}/dry-run | Exécute le graphe du pipeline en mode simulation afin de calculer les créations, mises à jour, éléments ignorés et erreurs qui seraient produits. Aucun résultat métier n’est persisté, ce qui permet d’évaluer l’impact du traitement avant de lancer une exécution réelle. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/health | Agrège le taux de succès, la durée moyenne et les tendances d’erreur récentes du pipeline. Ces indicateurs donnent une lecture rapide de sa fiabilité opérationnelle et permettent de détecter une dégradation sans inspecter chaque exécution séparément. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/runs | Retourne de façon paginée l’historique des exécutions enregistrées pour le pipeline ciblé. Chaque entrée permet de repérer son état et son contexte temporel afin de suivre l’activité, retrouver un incident ou sélectionner une exécution à inspecter. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/runs/{runId} | Fournit le statut, les résultats disponibles et les erreurs associées à une exécution précise du pipeline. Cette lecture permet de diagnostiquer un traitement ou d’alimenter une interface de suivi sans relancer ni modifier l’exécution. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/runs/{runId}/blocks | Détaille pour chaque bloc de l’exécution les durées, volumes traités et erreurs enregistrées. Cette granularité permet de localiser une étape lente ou défaillante et de comprendre la progression du pipeline sans parcourir un journal technique global. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/runs/{runId}/comments | Retourne les commentaires collaboratifs rattachés à une exécution précise du pipeline. Cette discussion contextualise les incidents, décisions et vérifications de l’équipe tout en restant liée à l’exécution concernée pour préserver la traçabilité. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/runs/diff | Compare deux exécutions du même pipeline selon leurs résultats, leurs durées et leurs erreurs. Cette vue différentielle aide à mesurer l’effet d’une nouvelle version ou d’un changement de données et à isoler rapidement les écarts significatifs. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/schema-drift | Compare le schéma actuel de la source avec le dernier instantané compatible enregistré pour le pipeline. La réponse met en évidence les différences susceptibles d’affecter le traitement afin qu’elles puissent être examinées avant une prochaine exécution ou évolution de configuration. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
POST | /api/v1/data-pipelines/{id}/validate | Vérifie la structure du graphe et la configuration de chaque bloc sans démarrer le pipeline. La réponse distingue les problèmes qui empêchent l’exécution des avertissements à examiner, afin de corriger la définition sans modifier les données du workspace. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/versions | Liste les versions enregistrées du pipeline avec les informations permettant de situer leurs changements de configuration. Cet historique aide à suivre son évolution, sélectionner un état antérieur et préparer une comparaison ou une restauration contrôlée. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
GET | /api/v1/data-pipelines/{id}/versions/{version} | Retourne la configuration complète du pipeline telle qu’elle a été enregistrée pour la version demandée. Cette représentation immuable permet d’auditer un état historique ou de vérifier précisément ce qui serait restauré, sans modifier la version courante. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
POST | /api/v1/data-pipelines/detect-schema | Analyse une source ou un jeu de données accessible dans le workspace et retourne les colonnes ainsi que les types détectés. Cette inspection prépare la configuration d’un pipeline ou de ses mappings mais ne crée aucune définition de pipeline et ne transforme pas les données. | X-API-Key + x-workspace-id | data-pipelines-read-models-20260804180959 |
Decision
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/decision-compares | Crée une comparaison asynchrone entre les options fournies et retourne l’emplacement à interroger pour suivre son avancement. La clé d’idempotence évite de dupliquer une même demande lorsque le client répète son appel. | X-API-Key + x-workspace-id | decision-compare-contract-v1 |
DELETE | /api/v1/decision-compares/{runId} | Demande l’arrêt au mieux d’une comparaison encore active afin d’éviter la poursuite de calculs devenus inutiles. L’annulation conserve les éléments de preuve et l’historique déjà produits, et ne garantit pas l’interruption d’une étape déjà terminée. | X-API-Key + x-workspace-id | decision-compare-contract-v1 |
GET | /api/v1/decision-compares/{runId} | Retourne l’état courant d’une comparaison appartenant au workspace, avec les informations disponibles sur sa progression. Le client peut interroger cette ressource jusqu’à l’obtention d’un résultat final ou d’un état terminal. | X-API-Key + x-workspace-id | decision-compare-contract-v1 |
GET | /api/v1/decision-compares/{runId}/evidence | Fournit l’instantané des preuves utilisées par la comparaison ainsi que son empreinte SHA-256. Ces éléments permettent d’auditer le raisonnement, de vérifier l’intégrité de la restitution hors ligne et de distinguer les preuves calculées des décisions humaines. | X-API-Key + x-workspace-id | decision-compare-contract-v1 |
POST | /api/v1/decision-compares/{runId}/override | Enregistre le choix explicite d’un utilisateur lorsqu’il décide de déroger à la recommandation issue de la comparaison. Cette décision est traçable et n’altère ni les preuves calculées ni le rapport qui a conduit à l’arbitrage. | X-API-Key + x-workspace-id | decision-compare-contract-v1 |
GET | /api/v1/decision-compares/{runId}/report | Retourne le rapport public scellé d’une comparaison arrivée à son terme avec succès. Ce document rassemble la restitution exploitable de la comparaison et reste indisponible tant que l’exécution ne possède pas de résultat final valide. | X-API-Key + x-workspace-id | decision-compare-contract-v1 |
POST | /api/v1/decision-compares/estimate | Évalue de façon synchrone le coût attendu, le nombre d’étapes et le niveau de preuve d’une comparaison envisagée. L’estimation aide à choisir une configuration adaptée avant lancement et ne crée aucune exécution persistante. | X-API-Key + x-workspace-id | decision-compare-contract-v1 |
Graph
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/graph/constrained-search | Délimite d’abord un voisinage autorisé autour d’un nœud, puis applique la recherche vectorielle et le reclassement uniquement sur cette population. Cette combinaison réduit les faux rapprochements en imposant une proximité structurelle en plus de la similarité sémantique. | X-API-Key + x-workspace-id | specialized-graph-context-reads-v1-20260909120432 |
POST | /api/v1/graph/expand | Identifie d’abord des nœuds d’ancrage par similarité vectorielle, puis développe leur voisinage dans les limites demandées. Le résultat combine pertinence sémantique et structure relationnelle afin de fournir un contexte explicable et borné au workspace actif. | X-API-Key + x-workspace-id | specialized-graph-context-reads-v1-20260909120432 |
POST | /api/v1/graph/impact | Suit les dépendances à partir d’un nœud pour identifier les éléments susceptibles d’être affectés par son évolution. Le parcours respecte les limites de profondeur et de volume, et retourne un rayon d’impact exploitable pour préparer un changement sans prétendre couvrir le graphe au-delà de ces bornes. | X-API-Key + x-workspace-id | specialized-graph-context-reads-v1-20260909120432 |
GET | /api/v1/graph/neighbors/{entityId} | Retourne les nœuds directement reliés au nœud demandé ainsi que les relations qui expliquent leur proximité. Cette lecture limitée à un saut convient à l’exploration interactive et respecte les frontières d’accès du workspace actif. | X-API-Key + x-workspace-id | external-data-contract-v1 |
POST | /api/v1/graph/paths | Calcule un chemin borné entre deux nœuds du graphe et restitue dans l’ordre les relations traversées. Cette opération aide à expliquer comment deux entités sont connectées sans explorer ni retourner l’ensemble du graphe du workspace. | X-API-Key + x-workspace-id | external-data-contract-v1 |
POST | /api/v1/graph/traverse | Explore le graphe à partir d’un nœud de départ en respectant les limites de profondeur et de volume fournies. La réponse restitue les nœuds et relations atteints dans le workspace, ce qui permet de construire une vue de voisinage sans lancer un parcours non borné. | X-API-Key + x-workspace-id | external-data-contract-v1 |
Graphrag
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/vectors/search | Transforme le texte fourni en vecteur de requête puis recherche les entités les plus proches dans le seul workspace actif. Le résultat peut être limité à certains types d’entités et à un espace précis via l’en-tête X-Espace-Id. | X-API-Key + x-workspace-id | specialized-vector-observability-search-v1-20260918101957 |
GET | /api/v1/vectors/stats | Retourne le nombre de vecteurs du workspace actif, la collection Qdrant utilisée et la spécification d’embedding courante. Les compteurs globaux de la collection partagée ne sont pas exposés. | X-API-Key + x-workspace-id | specialized-vector-observability-search-v1-20260918101957 |
Ia
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/agent-lifecycle/agents | Liste par pages les définitions d’agents du workspace avec leur identité stable, leur état de cycle de vie et, lorsqu’elle existe, leur version actuellement publiée. La réponse indique si une autre page est disponible. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
GET | /api/v1/agent-lifecycle/agents/{id} | Retourne la définition de l’agent demandé dans le workspace actif, notamment son identifiant API stable, son statut et la référence de sa version publiée. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
POST | /api/v1/agent-lifecycle/agents/{id}/invoke | Exécute précisément la version publiée et déployée de l’agent demandé dans le workspace actif. La réponse identifie la version effectivement utilisée et la session conserve cette référence pour l’audit et la traçabilité. | X-API-Key + x-workspace-id | agent-lifecycle-invocation-v1-20260918094058 |
GET | /api/v1/agent-lifecycle/deployment-events | Liste de façon paginée les promotions et rollbacks d’un agent afin de restituer sa chronologie de déploiement. Les motifs sont expurgés et les approbateurs représentés par une référence pseudonyme propre au workspace. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
GET | /api/v1/agent-lifecycle/eval-runs | Liste les évaluations récentes associées à une version d’agent, avec leurs mesures de qualité, coût, latence et couverture de traces dans le workspace actif. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
POST | /api/v1/agent-lifecycle/eval-runs | Démarre en arrière-plan l’évaluation d’une version d’agent sur un jeu de données du workspace verrouillé par sa date de mise à jour. La clé d’idempotence évite les doublons et les limites de taille et de concurrence maîtrisent la consommation. | X-API-Key + x-workspace-id | agent-lifecycle-evaluation-v1-20260918094053 |
GET | /api/v1/agent-lifecycle/eval-runs/{id} | Retourne le détail d’une évaluation précise et de ses mesures après vérification de son appartenance au workspace actif. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
GET | /api/v1/agent-lifecycle/eval-runs/compare | Retourne côte à côte les évaluations les plus récentes et indique explicitement si la comparaison est concluante. Les écarts de qualité, coût et latence ne sont calculés que pour deux versions du même agent évaluées sur le même jeu de données. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
GET | /api/v1/agent-lifecycle/evaluation-requests/{id} | Consulte l’état, la progression et le résultat d’une demande d’évaluation dans le workspace actif, y compris les interruptions et les échecs. | X-API-Key | ai-evaluation-status-reads-v1-20260918094114 |
GET | /api/v1/agent-lifecycle/versions | Retourne l’historique borné des versions d’un agent du workspace, de la plus récente à la plus ancienne, avec leur état de cycle de vie et leurs références d’évaluation et de déploiement. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
GET | /api/v1/agent-lifecycle/versions/{id} | Retourne une version précise d’un agent, son instantané de configuration et son état dans le cycle de vie gouverné, après contrôle de son appartenance au workspace. | X-API-Key + x-workspace-id | ai-agent-lifecycle-reads-v1-20260918094124 |
POST | /api/v1/agent-lifecycle/versions/{id}/promote | Déploie atomiquement une version évaluée, archive la version précédemment active et enregistre un événement d’audit. La mutation exige un motif, les autorisations appropriées et une évaluation attachée à la version cible. | X-API-Key + x-workspace-id | ai-demo-preview-mutations-v1-20260918094103 |
POST | /api/v1/agent-lifecycle/versions/{id}/rollback | Restaure une version cible comme version déployée au moyen du même parcours transactionnel et audité que la promotion. Le rollback exige un motif explicite et conserve l’historique des changements. | X-API-Key + x-workspace-id | ai-demo-preview-mutations-v1-20260918094103 |
GET | /api/v1/agent/costs | Liste de façon bornée les coûts associés aux sessions Agent du workspace actif. Cette lecture permet de suivre la consommation et d’alimenter les vues FinOps sans exposer les requêtes, réponses ou données métier traitées par les sessions. | X-API-Key | ai-agent-runtime-reads-v1-20260918094119 |
GET | /api/v1/agent/sessions/{id}/evidence | Retourne une projection bornée et expurgée des faits, citations, sources et limites associés à une session du workspace. Le bundle forensique brut, les secrets et les données hors contrat ne sont jamais exposés. | X-API-Key | ai-agent-evidence-reads-v1-20260918094114 |
GET | /api/v1/agent/sessions/{id}/explain | Diffuse les événements d’explicabilité d’une session via SSE avec identifiants ordonnés, heartbeat, reprise bornée par Last-Event-ID et reconnexion contrôlée. Une session terminée restitue directement son artefact final. | X-API-Key | ai-agent-evidence-reads-v1-20260918094114 |
GET | /api/v1/agent/sessions/{id}/explainability | Retourne l’artefact final persisté d’une session terminée : détection d’intention, ancrage, planification, décisions d’exécution, contraintes et résultat. La lecture est limitée au workspace associé à la clé API. | X-API-Key | ai-agent-evidence-reads-v1-20260918094114 |
POST | /api/v1/agent/sessions/{id}/feedback | Enregistre une évaluation expurgée pour une session appartenant au workspace actif, sans recopier la question ni la réponse. Une clé d’idempotence rend les répétitions sûres et empêche qu’une même clé modifie silencieusement un avis déjà enregistré. | X-API-Key | agent-feedback-v1-20260918094043 |
GET | /api/v1/agent/sessions/{id}/trace | Retourne la chronologie structurée d’une session Agent du workspace : appels de modèles, outils utilisés, décisions de routage, éléments de grounding, coûts et latences disponibles. Les entrées et sorties détaillées des outils restent masquées sauf autorisation administrative explicite. | X-API-Key | ai-agent-runtime-reads-v1-20260918094119 |
GET | /api/v1/agent/tools/{name}/config-schema | Retourne le schéma versionné et les indications d’interface d’un outil effectivement autorisé dans le contexte du workspace. Un outil absent ou non accessible produit la même réponse afin de ne pas révéler des capacités internes. | X-API-Key | ai-agent-tool-schema-reads-v1-20260918094113 |
POST | /api/v1/ontology/ai-assist | Produit des suggestions bornées à partir de l’ontologie lisible du workspace et indique le provider et le modèle effectivement utilisés. Cet appel ne modifie aucune donnée : l’application des suggestions reste une commande distincte du Modeler, soumise à ses propres contrôles. | X-API-Key | ai-ontology-assist-reads-v1-20260918094131 |
Instances
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/instances/{id} | Retourne l’instance identifiée avec l’ensemble de ses propriétés après vérification de son appartenance au workspace actif. Cette lecture fournit la représentation métier complète de l’objet sans inclure automatiquement les relations, disponibles par une opération dédiée. | X-API-Key + x-workspace-id | safe-evaluations-and-instance-views-20260804180943 |
GET | /api/v1/instances/{id}/edges | Retourne une page bornée des relations entrantes et sortantes dans le workspace, avec total exact, offset et indication de couverture pour poursuivre la lecture. La réponse permet de comprendre le voisinage direct sans lancer une exploration récursive. | X-API-Key + x-workspace-id | core-instance-evaluation-reads-v1-20260829082711 |
GET | /api/v1/object-types/{id}/instances | Retourne les instances actives appartenant au type d’objet demandé dans le workspace, avec filtres de statut et pagination. Cette lecture sert à construire des listes métier ou à parcourir progressivement une population sans charger toutes ses propriétés en une seule fois. | X-API-Key + x-workspace-id | core-instance-evaluation-reads-v1-20260829082711 |
POST | /api/v1/object-types/{id}/instances/aggregate | Calcule des métriques exactes sur les instances canoniques autorisées, avec filtres, groupes et limites explicites. Les sources fédérées sont exclues. | X-API-Key + x-workspace-id | specialized-instance-analytics-reads-v1-20260918132026 |
GET | /api/v1/object-types/{id}/instances/export | Génère un fichier CSV à partir des instances du type d’objet sélectionné que le demandeur est autorisé à consulter. Le format tabulaire facilite une analyse externe ou un échange de données tout en maintenant le filtrage et l’isolation du workspace. | X-API-Key + x-workspace-id | core-instance-evaluation-reads-v1-20260829082711 |
POST | /api/v1/object-types/{id}/instances/search | Recherche les instances d’un type d’objet par texte, propriétés, tri et pagination. | X-API-Key + x-workspace-id | core-instance-evaluation-reads-v1-20260918154506 |
GET | /api/v1/object-types/{objectTypeId}/views | Liste de façon paginée les vues personnelles et partagées disponibles pour le type d’objet ciblé. Le client peut ainsi proposer les filtres, colonnes et tris déjà enregistrés par les utilisateurs sans charger les données des instances elles-mêmes. | X-API-Key + x-workspace-id | core-instance-evaluation-reads-v1-20260829082711 |
Live data
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/streams/{streamId}/link | Crée une liaison entre le flux Live Data ciblé et un nœud d’ontologie appartenant au même workspace. Cette association déclare la destination métier alimentée par le flux ; elle ne déplace pas la source et respecte l’isolation entre workspaces. | X-API-Key + x-workspace-id | live-data-stream-links |
GET | /api/streams/{streamId}/nodes | Retourne les nœuds d’ontologie du workspace actuellement alimentés par le flux Live Data demandé. Cette lecture permet de visualiser la destination des données et de vérifier les liaisons existantes avant d’en ajouter ou d’en retirer une. | X-API-Key + x-workspace-id | live-data-stream-links |
DELETE | /api/streams/{streamId}/unlink/{nodeId} | Retire la liaison entre le flux Live Data et le nœud d’ontologie demandé. La source, le flux et l’entité restent disponibles : seule leur association d’alimentation est supprimée, ce qui évite une destruction involontaire des ressources. | X-API-Key + x-workspace-id | live-data-stream-links |
DELETE | /api/unified-sources/{id} | Supprime définitivement la source de données ciblée dans le workspace ainsi que les flux techniques qui lui sont associés. Cette opération retire la configuration de connexion mais ne doit pas être confondue avec la suppression des données métier déjà matérialisées à partir de cette source. | X-API-Key + x-workspace-id | live-data-source-deletion |
Mcp
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/mcp/info | Présente les informations nécessaires pour connecter un client au serveur MCP : version du protocole, transport pris en charge, capacités annoncées et points d’entrée OAuth. Cette lecture publique sert à négocier la connexion et à configurer le client sans exposer le contenu des sessions ni les données d’un workspace. | Public | mcp-read-surface-v1-20260909074510 |
GET | /api/mcp/stats | Fournit une vue opérationnelle des volumes du registre MCP et de l’activité des sessions accessibles au principal courant. Cette lecture exige le scope MCP approprié et expose des agrégats de fonctionnement, pas le contenu détaillé des conversations ou des outils exécutés. | X-API-Key + x-workspace-id | mcp-read-surface-v1-20260909074510 |
GET | /api/mcp/tools | Retourne le catalogue des outils publiés sur la surface MCP, avec leur catégorie, leur schéma d’entrée et les métadonnées utiles au routage. Un client peut s’appuyer sur cette réponse pour construire des appels valides ; seuls les outils visibles pour cette surface sont inclus. | X-API-Key + x-workspace-id | mcp-read-surface-v1-20260909074510 |
Migrationbackbone
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/migration-backbone/cutover-packs | Liste les dossiers préparés pour décider une bascule, avec leur rapprochement associé et leur statut courant. Cette vue de pilotage permet de distinguer les dossiers incomplets, en attente d’approbation ou prêts à être examinés par les responsables. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/cutover-packs/{id} | Retourne les preuves, approbations, plan de retour arrière et empreinte d’audit réunis pour une décision de bascule. Le dossier offre une vue traçable des conditions de passage en production et des mesures prévues si la migration doit être annulée. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/materialization-plans | Retourne les plans multi-objets du workspace avec leur statut et l’état de leur dernière exécution. Cette vue permet de piloter les transformations prévues, d’identifier les plans encore en préparation et de retrouver ceux qui sont prêts à être examinés. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/materialization-plans/{id} | Détaille les étapes ordonnées, les mappings et les métadonnées du plan de matérialisation demandé. La réponse expose comment chaque source doit devenir une instance ou une relation d’ontologie afin de permettre une revue complète avant approbation ou exécution. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/materialization-runs | Liste les exécutions qui transforment les données sources en instances d’ontologie, avec leurs états et volumes observés. Cette chronologie permet de suivre les traitements de matérialisation, de repérer les échecs et de choisir une exécution à rapprocher ou diagnostiquer. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/reconciliation-runs | Liste les contrôles qui comparent les données sources aux entités matérialisées, avec leur état et leur décision d’aptitude à la bascule. Cette vue aide à retrouver les vérifications récentes et à identifier les migrations qui présentent encore des écarts. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/reconciliation-runs/{id} | Retourne les volumes attendus et observés, les écarts mesurés, les seuils appliqués et la décision d’aptitude enregistrée. Cette restitution fournit les éléments quantitatifs nécessaires pour expliquer pourquoi une migration peut ou non poursuivre vers la bascule. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/source-contracts | Liste les contrats relationnels du workspace en permettant de filtrer par statut, dataset, système source ou table. Cette vue sert à inventorier les structures déjà découvertes, à suivre leur maturité et à sélectionner le contrat à examiner avant matérialisation. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/source-contracts/{id} | Retourne le schéma relationnel, les clés, la traçabilité et l’état du contrat de source demandé. Cette lecture permet de vérifier les hypothèses de structure et d’identification avant de transformer les données en objets de l’ontologie. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/source-contracts/by-dataset/{datasetId} | Retrouve la version la plus récente du contrat de migration associée au dataset gouverné demandé. Cette route simplifie le passage depuis le catalogue de données vers son schéma de migration sans que le client ait à connaître préalablement l’identifiant du contrat. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-backbone/summary | Synthétise les volumes, les derniers artefacts produits et les blocages connus du parcours de migration dans le workspace. Cette vue donne aux équipes une lecture immédiate de l’avancement et des prochaines décisions à prendre sans ouvrir chaque contrat ou exécution. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
Migrationprojects
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/migration-projects | Liste les projets de migration du workspace avec leur état, leur système source et leur niveau de préparation calculé. Cette vue permet de suivre plusieurs chantiers en parallèle, de repérer leurs blocages et de sélectionner le projet nécessitant une action. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
GET | /api/v1/migration-projects/{id} | Retourne les étapes du projet, ses artefacts liés, ses blocages connus et les indicateurs qui déterminent son niveau de préparation. Cette vue consolidée relie contrats, plans, rapprochements et décisions afin d’expliquer l’état courant du chantier. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
Ontology
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/ontology/{type}/{id}/consumers | Recense les workflows, agents, tableaux de bord et autres ressources qui référencent un élément d’ontologie donné. Cette analyse d’impact permet d’évaluer les dépendances avant de renommer, faire évoluer ou retirer cet élément. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/{type}/{id}/consumers/count | Retourne uniquement le nombre de ressources qui consomment l’élément d’ontologie ciblé. Cette variante légère convient aux badges, contrôles préalables et tableaux de synthèse lorsqu’il n’est pas nécessaire de charger la liste complète des dépendances. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/{type}/{id}/dependencies | Identifie les éléments d’ontologie référencés par un workflow, un agent ou un autre consommateur gouverné. La réponse permet de comprendre les prérequis du consommateur, de vérifier leur disponibilité et de préparer une migration ou une analyse d’impact. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
POST | /api/v1/ontology/aggregate | Calcule des indicateurs tels que comptes, sommes, moyennes, minimums ou maximums sur un type d’objet autorisé. Les filtres et regroupements fournis délimitent la population analysée, et l’opération reste strictement en lecture seule. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
POST | /api/v1/ontology/analytics/relations | Suit un chemin dirigé explicite entre instances autorisées et agrège les champs racine ou terminaux. La multiplicité par chemins ou par paires distinctes est obligatoire et les dépassements échouent sans résultat partiel. | X-API-Key + x-workspace-id | specialized-instance-relation-analytics-reads-v1-20260918132652 |
GET | /api/v1/ontology/health | Regroupe les métriques de qualité du workspace, les problèmes structurels détectés et les suggestions de correction disponibles. Ce diagnostic aide à prioriser les travaux de gouvernance mais ne corrige ni ne publie automatiquement aucun élément. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/manifest | Expose le contrat machine courant de l’ontologie : types d’objet, liens, interfaces et actions utilisables par les intégrations. Les SDK peuvent télécharger ce manifeste pour générer leurs modèles, valider leurs appels et rester synchronisés avec la version publiée du workspace. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/manifest/version | Retourne la version persistée du manifeste ou, lorsqu’elle n’existe pas, son empreinte déterministe. Cette lecture légère permet à un client de détecter un changement de contrat et de ne retélécharger le manifeste complet que lorsque cela est nécessaire. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
POST | /api/v1/ontology/query | Exécute une requête ObjectSet en lecture seule sur un type d’objet du workspace, avec filtres, projection, tri et pagination. Les bornes appliquées à la requête protègent le service contre les lectures trop larges ; aucune instance ni définition d’ontologie n’est modifiée. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/search | Recherche les types d’objet et les types de lien du workspace à partir de leur nom, alias, description ou propriétés. Le résultat aide à retrouver les identifiants et définitions pertinentes avant une requête métier, tout en restant limité aux éléments que le demandeur est autorisé à consulter. | X-API-Key + x-workspace-id | core-ontology-reads-v1-20260805180403 |
GET | /api/v1/ontology/stats | Synthétise les volumes de types d’objet et de lien du workspace en distinguant notamment les éléments publiés des brouillons. Cette vue agrégée permet de suivre la taille et l’état de préparation de l’ontologie sans charger le détail de chaque définition. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/stats/espaces | Répartit les volumes de types d’objet et de lien entre les différents espaces de l’ontologie du workspace. Cette ventilation permet d’identifier les zones les plus riches ou les moins structurées et de comparer leur niveau de publication. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/value-types | Liste les types de valeur système et personnalisés disponibles pour définir les propriétés de l’ontologie. La réponse permet aux éditeurs et intégrations de proposer uniquement des types compatibles avec le workspace avant de construire ou valider un schéma. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
GET | /api/v1/ontology/value-types/{id} | Retourne la définition complète d’un type de valeur précis, telle qu’elle est accessible dans le workspace actif. Cette lecture fournit le contrat à utiliser pour interpréter ou valider les propriétés qui référencent ce type, sans modifier sa configuration. | X-API-Key + x-workspace-id | ontology-core-reads-v1-20260728132642 |
Permissions
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/permissions/definitions | Retourne le référentiel canonique des permissions pouvant être attribuées aux rôles et utilisées dans les contrôles d’accès du workspace. Cette liste permet aux interfaces d’administration de présenter des choix valides et aux intégrations de vérifier les identifiants avant toute configuration. | X-API-Key + x-workspace-id | client-control-plane-reads-20260728064747 |
Rag
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/rag/context | Sélectionne les passages du workspace les plus pertinents pour une question ou un besoin de contexte. La réponse est destinée à être transmise à votre propre modèle de langage et conserve les informations nécessaires pour relier les extraits à leurs sources. | X-API-Key + x-workspace-id | external-data-contract-v1 |
POST | /api/v1/rag/embed | Transforme une liste de textes en représentations vectorielles avec le modèle d’embedding configuré pour le workspace. Ces vecteurs peuvent ensuite alimenter une indexation ou une comparaison sémantique ; l’opération ne publie pas à elle seule de nouvelles données métier. | X-API-Key + x-workspace-id | external-data-contract-v1 |
Recherches
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/documentation/search | Recherche les documents par stratégie lexicale, sémantique, hybride ou GraphRAG explicite, avec passages et preuve du mode réellement exécuté. | X-API-Key + x-workspace-id | specialized-documentation-search-reads-v1-20260918151025 |
POST | /api/v1/instances/{id}/context | Lit les propriétés demandées et, en option, les relations directes sous edges.read et les passages associés sous knowledge.read. Citations bornées, procédures explicitement taguées sans autorité exécutable, couverture non exhaustive et lectures revérifiées. Aucune matérialisation. | X-API-Key + x-workspace-id | specialized-instance-fact-context-reads-v1-20260918190833 |
GET | /api/v1/instances/{id}/neighborhood | Parcourt de façon bornée les relations d’une instance et retourne les nœuds, arêtes et diagnostics de troncature autorisés. | X-API-Key + x-workspace-id | specialized-instance-neighborhood-reads-v1-20260918154519 |
GET | /api/v1/knowledge/documents/{id}/similar | Recherche par similarité sémantique les documents proches d’un document source autorisé dans le workspace actif. | X-API-Key + x-workspace-id | specialized-document-similarity-reads-v1-20260918151018 |
GET | /api/v1/knowledge/entities/{entityId}/documents | Liste les documents accessibles liés à une entité du workspace actif, après contrôle des permissions et des ACL documentaires. | X-API-Key + x-workspace-id | specialized-entity-document-reads-v1-20260918190313 |
POST | /api/v1/knowledge/entities/search | Recherche lexicalement les entités d’ontologie et retourne le nombre et un aperçu des documents qui leur sont liés. | X-API-Key + x-workspace-id | specialized-knowledge-entity-search-reads-v1-20260918151031 |
POST | /api/v1/knowledge/similar | Recherche par similarité sémantique les documents proches du contenu textuel fourni dans le workspace actif. | X-API-Key + x-workspace-id | specialized-content-similarity-reads-v1-20260918151039 |
POST | /api/v1/ontology/structure/similar | Compare séparément les propriétés lisibles ou la forme des LinkTypes actifs de niveau schéma : direction, cardinalité et multiplicité, avec extrémités UUID autorisées et justificatifs. Signatures versionnées ; relations inférées, héritage et compatibilité non évalués. | X-API-Key + x-workspace-id | specialized-ontology-structure-similarity-reads-v1-20260918125949 |
GET | /api/v1/retrieval/capabilities | Présente les surfaces, modes, limites et dépendances initialisées. La disponibilité annoncée ne constitue pas une certification de qualité ou de fraîcheur. | X-API-Key + x-workspace-id | specialized-retrieval-composition-reads-v1-20260918102056 |
POST | /api/v1/retrieval/explain | Exécute la recherche composée avec les mêmes contrôles que retrieval/search puis restitue modes, sources, replis, couverture, volumes et statistiques de classement, sans contenu métier ni valeur de filtre. | X-API-Key + x-workspace-id | retrieval-composition-reads-v1-20260921171241 |
POST | /api/v1/retrieval/facets | Compte une population explicite : instances, documents, processus ou records fédérés ciblés. Totaux exhaustifs malgré la troncature des valeurs ; aucune somme implicite inter-sources ni capacité exécutée. | X-API-Key + x-workspace-id | specialized-retrieval-facets-reads-v1-20260918132040 |
POST | /api/v1/retrieval/recommend | Classe les définitions courantes autorisées en mode lexical ou sémantique explicite, avec contre-exemples et scores détaillés. Embeddings courants à la demande sur petit catalogue borné ; aucune exécution ni repli implicite. | X-API-Key + x-workspace-id | specialized-retrieval-recommend-reads-v1-20260918110909 |
POST | /api/v1/retrieval/search | Recherche les processus, instances et documents autorisés, avec résultats par surface, modes exécutés, couverture partielle et contexte cité optionnel. | X-API-Key + x-workspace-id | specialized-retrieval-composition-reads-v1-20260918130438 |
GET | /api/v1/search/global | Fédère une recherche lexicale entre définitions, instances, workflows, actions et vues enregistrées, selon les scopes de lecture disponibles. | X-API-Key + x-workspace-id | specialized-global-search-reads-v1-20260918190259 |
Scenarios
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/scenarios | Crée un espace de simulation isolé à partir de l’ontologie courante du workspace selon un modèle copy-on-write. Les modifications réalisées dans le scénario restent séparées de la source afin de tester des hypothèses sans altérer les données ou définitions de référence. | X-API-Key + x-workspace-id | scenario-core-contracts |
GET | /api/v1/scenarios/{id} | Retourne le scénario demandé avec son état et les modifications isolées qu’il porte dans le workspace. Cette lecture permet de revoir une hypothèse ou d’alimenter une restitution tout en distinguant clairement les changements simulés de l’ontologie de référence. | X-API-Key + x-workspace-id | scenario-core-contracts |
Search
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/search | Recherche dans l’ontologie du workspace selon un mode déterministe, lexical, sémantique ou hybride choisi explicitement. La réponse indique les résultats pertinents dans le périmètre autorisé ; le mode auto demeure une orchestration et ne masque pas le mode de recherche réellement exécuté. | X-API-Key + x-workspace-id | external-data-contract-v1 |
Semantic
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/semantic/query | Interprète une question en langage naturel, la traduit en requête SQL ou graphe adaptée, puis l’exécute dans le périmètre du workspace. La réponse fournit le résultat de cette exécution et évite au client de construire lui-même la syntaxe de requête sous-jacente. | X-API-Key + x-workspace-id | external-data-contract-v1 |
Status
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/status | Présente l’état des services nécessaires aux API publiques, les éventuels signaux de dérive et les indicateurs de disponibilité exposés au client. Cette vue permet à une intégration de distinguer un service opérationnel d’un fonctionnement dégradé avant de lancer des traitements dépendants. | X-API-Key + x-workspace-id | external-data-contract-v1 |
Transfer
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
POST | /api/v1/workflows/validate | Analyse une définition de workflow portable avant son import et retourne les erreurs bloquantes ainsi que les avertissements détectés. Cette prévalidation permet de corriger le document en amont et ne crée, ne remplace ni n’exécute aucune ressource dans le workspace. | X-API-Key + x-workspace-id | safe-evaluations-and-instance-views-20260804180943 |
Vectors
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/v1/vectors | Retourne de façon paginée les vecteurs indexés dans le workspace avec les métadonnées permettant de les identifier et de comprendre leur provenance. Cette vue sert au contrôle de l’index sans charger tout le catalogue en une seule réponse. | X-API-Key + x-workspace-id | external-data-contract-v1 |
GET | /api/v1/vectors/{entityId} | Retourne un vecteur indexé précis et ses métadonnées après vérification de son appartenance au workspace actif. Cette lecture permet d’inspecter une entrée d’index ou de diagnostiquer sa provenance sans exposer les vecteurs d’un autre espace. | X-API-Key + x-workspace-id | external-data-contract-v1 |
Workflow
| Méthode | Endpoint | Contrat fonctionnel | Accès | Lot de preuve |
|---|---|---|---|---|
GET | /api/logic/functions | Liste les workflows accessibles dans le workspace avec leurs métadonnées principales. Cette vue permet de retrouver une automatisation, d’afficher un catalogue ou de sélectionner un workflow sans télécharger immédiatement chaque définition de flux complète. | X-API-Key + x-workspace-id | workflow-crud-staging-2026-06-12 |
POST | /api/logic/functions | Crée un nouveau workflow dans le workspace avec sa première définition de flux. La ressource obtenue peut ensuite être complétée et exécutée ; la création reste isolée au workspace indiqué par le contexte de la requête. | X-API-Key + x-workspace-id | workflow-crud-staging-2026-06-12 |
DELETE | /api/logic/functions/{id} | Supprime définitivement le workflow ciblé et les exécutions qui lui sont rattachées. Cette opération destructive doit être réservée aux automatisations qui ne sont plus nécessaires, car leur définition et leur historique ne sont pas conservés par cette suppression. | X-API-Key + x-workspace-id | workflow-crud-staging-2026-06-12 |
GET | /api/logic/functions/{id} | Retourne les métadonnées du workflow demandé ainsi que sa définition de flux exploitable par un éditeur ou une intégration. L’accès est vérifié dans le workspace actif afin de ne jamais exposer une automatisation appartenant à un autre espace. | X-API-Key + x-workspace-id | workflow-crud-staging-2026-06-12 |
Source : manifeste de publication API Manager, état consolidé au 2026-10-02. Toute modification manuelle de cette page est rejetée par la CI.
