Renvoie l’avancement du job : queued, running, succeeded ou failed.
En succeeded, configuration_version porte la version désormais active.
En failed, error contient une cause bornée et un message lisible : ni
trace interne, ni prompt, ni contenu de lot n’est exposé.
Envoyez la clé API dans Authorization: Bearer <clé>. Elle identifie le domaine et les droits autorisés. Ne transmettez pas d'en-têtes d'identité internes.
Paramètres de chemin
compilation_id
string
requis
Required string length: 1 - 128
Réponse
Statut du job.
request_id
string
requis
compilation_id
string
requis
Required string length: 1 - 128
status
enum<string>
requis
Options disponibles:
queued,
running,
succeeded,
failed
draft_revision
integer
requis
Plage requise: x >= 0
created_at
string<date-time>
requis
updated_at
string<date-time>
requis
progress
number
requis
Avancement indicatif, sans garantie de linéarité.
Plage requise: 0 <= x <= 1
error
object | null
requis
Cause bornée d'un échec de compilation. Aucune trace interne, aucun prompt et
aucun contenu de lot n'est exposé.
details n'est renseigné que pour validation_failed, dont les erreurs sont
corrigeables par l'éditeur ; pour llm_unavailable, timeout et
internal_error, il reste absent.
Show child attributes
configuration_version
string | null
requis
Version désormais active, renseignée uniquement en succeeded.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Zelinqa","colors":{"primary":"#7C3AED","light":"#A78BFA","dark":"#8B5CF6"},"logo":{"light":"https://mintcdn.com/zelinqa-d77427f3/NHQX6jXz7QClMoqF/logo/light.svg?fit=max\u0026auto=format\u0026n=NHQX6jXz7QClMoqF\u0026q=85\u0026s=6cbe3336a207008182be0916b85b70ef","dark":"https://mintcdn.com/zelinqa-d77427f3/NHQX6jXz7QClMoqF/logo/dark.svg?fit=max\u0026auto=format\u0026n=NHQX6jXz7QClMoqF\u0026q=85\u0026s=7ff1e5b30a949dd04c9ea9b6f3e6beaa","href":"https://zelinqa.ai"},"favicon":"https://mintcdn.com/zelinqa-d77427f3/04zoXbeL2ZlFQrrw/favicon.svg?fit=max\u0026auto=format\u0026n=04zoXbeL2ZlFQrrw\u0026q=85\u0026s=76e8077a8df9fee9dce67ea7cf0612cb","api":{"openapi":["openapi.fr.yaml","openapi.yaml"],"playground":{"display":"interactive"},"examples":{"languages":["bash","python","javascript"]}},"navbar":{"primary":{"type":"button","label":"Zelinqa Studio","href":"https://client.zelinqa.ai"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"fr","default":true,"href":"fr/introduction"},{"language":"en","href":"en/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zelinqa-d77427f3","hasAudioNarration":false,"actualSubdomain":"zelinqa-d77427f3","customDomains":["docs.zelinqa.ai"],"gitSource":{"type":"github","owner":"zelinqa","repo":"nbq-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad54348ae0c8a39b0082ad1","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"en","tag":"API Reference","count":17},{"language":"fr","tag":"Référence API","count":17},{"language":"en","tag":"Developers","count":14},{"language":"fr","tag":"Développeurs","count":14},{"language":"en","tag":"Zelinqa Studio","count":11},{"language":"fr","tag":"Zelinqa Studio","count":11},{"language":"en","tag":"Configure","count":6},{"language":"en","tag":"Configuration","count":6},{"language":"fr","tag":"Configurer","count":6},{"language":"fr","tag":"Configuration","count":6},{"language":"en","tag":"API guides","count":5},{"language":"en","tag":"Guides","count":5},{"language":"en","tag":"Publish and operate","count":5},{"language":"en","tag":"Sessions","count":5},{"language":"fr","tag":"Guides API","count":5},{"language":"fr","tag":"Guides","count":5},{"language":"fr","tag":"Publier et exploiter","count":5},{"language":"fr","tag":"Sessions","count":5},{"language":"en","tag":"Resources","count":3},{"language":"fr","tag":"Ressources","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":""}],"page":{"pagePath":"api-reference/configuration/suivre-un-job-de-compilation","slug":"/api-reference/configuration/suivre-un-job-de-compilation","pageMetadata":{"title":"Suivre un job de compilation","description":"Renvoie l'avancement du job : `queued`, `running`, `succeeded` ou `failed`.\n\nEn `succeeded`, `configuration_version` porte la version désormais active.\nEn `failed`, `error` contient une cause bornée et un message lisible : ni\ntrace interne, ni prompt, ni contenu de lot n'est exposé.\n","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/configuration/compilations/{compilation_id}","href":"/api-reference/configuration/suivre-un-job-de-compilation","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Renvoie l’avancement du job : \", _jsx(_components.code, {\n children: \"queued\"\n }), \", \", _jsx(_components.code, {\n children: \"running\"\n }), \", \", _jsx(_components.code, {\n children: \"succeeded\"\n }), \" ou \", _jsx(_components.code, {\n children: \"failed\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"En \", _jsx(_components.code, {\n children: \"succeeded\"\n }), \", \", _jsx(_components.code, {\n children: \"configuration_version\"\n }), \" porte la version désormais active.\\nEn \", _jsx(_components.code, {\n children: \"failed\"\n }), \", \", _jsx(_components.code, {\n children: \"error\"\n }), \" contient une cause bornée et un message lisible : ni\\ntrace interne, ni prompt, ni contenu de lot n’est exposé.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Suivre un job de compilation","description":"Renvoie l'avancement du job : `queued`, `running`, `succeeded` ou `failed`.\n\nEn `succeeded`, `configuration_version` porte la version désormais active.\nEn `failed`, `error` contient une cause bornée et un message lisible : ni\ntrace interne, ni prompt, ni contenu de lot n'est exposé.\n","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/configuration/compilations/{compilation_id}","href":"/api-reference/configuration/suivre-un-job-de-compilation","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["configuration"],"summary":"Suivre un job de compilation","description":"Renvoie l'avancement du job : `queued`, `running`, `succeeded` ou `failed`.\n\nEn `succeeded`, `configuration_version` porte la version désormais active.\nEn `failed`, `error` contient une cause bornée et un message lisible : ni\ntrace interne, ni prompt, ni contenu de lot n'est exposé.\n","operationId":"getCompilation","x-required-scopes":["configuration:read"],"parameters":["aa50dd57-4d8c-4238-989f-d0165bbeff70"],"responses":{"200":"d7a9b034-a7a9-4e0f-865c-4b79ead69461","401":"997a47dd-09c0-420d-a55a-0a5e47a7a82a","403":"11104a8e-c064-47af-8267-bf13512cd9f7","404":"0287d1d5-4ec3-428a-a092-fc964c95b9fc"},"method":"get","type":"path","servers":["1a6b3648-7307-43a6-aa3e-c2fc73c4533a"],"security":["9a21f59e-73e7-40cb-aed4-69ae805ab1b8"],"path":"/v1/configuration/compilations/{compilation_id}","baseUrlOptions":["https://api.zelinqa.ai"],"title":"Suivre un job de compilation","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"aa50dd57-4d8c-4238-989f-d0165bbeff70":{"name":"compilation_id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"d7a9b034-a7a9-4e0f-865c-4b79ead69461":{"description":"Statut du job.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["request_id","compilation_id","status","draft_revision","created_at","updated_at","progress","error","configuration_version"],"properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"compilation_id":{"type":"string","minLength":1,"maxLength":128,"isRequired":true,"uniqueKey":"compilation_id","typeLabel":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"draft_revision":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"draft_revision","typeLabel":"integer"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"progress":{"type":"number","minimum":0,"maximum":1,"description":"Avancement indicatif, sans garantie de linéarité.","isRequired":true,"uniqueKey":"progress","typeLabel":"number"},"error":{"oneOf":[{"type":"object","description":"Cause bornée d'un échec de compilation. Aucune trace interne, aucun prompt et\naucun contenu de lot n'est exposé.\n\n`details` n'est renseigné que pour `validation_failed`, dont les erreurs sont\ncorrigeables par l'éditeur ; pour `llm_unavailable`, `timeout` et\n`internal_error`, il reste absent.\n","required":["code","message"],"properties":{"code":{"type":"string","enum":["validation_failed","llm_unavailable","timeout","internal_error"],"isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["code","message"],"description":"Anomalie de configuration, structurée pour être affichée telle quelle dans Studio.","properties":{"code":{"type":"string","minLength":1,"maxLength":100,"description":"Code d'anomalie stable, en minuscules avec des traits de soulignement. Traitez les codes connus et affichez le message associé pour tout autre code ; le catalogue peut évoluer avec les règles de validation.","isRequired":true,"uniqueKey":"error.oneOf.0.details.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"error.oneOf.0.details.items.[INDEX].message","typeLabel":"string"},"entity":{"type":"string","enum":["objective","dimension","success_information","question"],"uniqueKey":"error.oneOf.0.details.items.[INDEX].entity","typeLabel":"enum\u003cstring>"},"entity_id":{"type":"string","maxLength":128,"uniqueKey":"error.oneOf.0.details.items.[INDEX].entity_id","typeLabel":"string"},"change_index":{"type":"integer","minimum":0,"description":"Position de l'opération fautive dans `changes`, lorsque l'anomalie vient d'un changement.","uniqueKey":"error.oneOf.0.details.items.[INDEX].change_index","typeLabel":"integer"}},"uniqueKey":"error.oneOf.0.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.oneOf.0.details","typeLabel":"object[]"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"},"configuration_version":{"oneOf":[{"type":"string","description":"Version désormais active, renseignée uniquement en `succeeded`.","isRequired":true,"uniqueKey":"configuration_version.oneOf.0","typeLabel":"string"},{"type":"null","description":"Version désormais active, renseignée uniquement en `succeeded`.","isRequired":true,"uniqueKey":"configuration_version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"configuration_version","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"en_cours":{"title":"en_cours","value":{"request_id":"req_8300","compilation_id":"cmp_01K2QF","status":"running","draft_revision":42,"created_at":"2026-09-01T09:20:11Z","updated_at":"2026-09-01T09:21:04Z","progress":0.45,"error":null,"configuration_version":null}},"terminee":{"title":"terminee","value":{"request_id":"req_8311","compilation_id":"cmp_01K2QF","status":"succeeded","draft_revision":42,"created_at":"2026-09-01T09:20:11Z","updated_at":"2026-09-01T09:23:47Z","progress":1,"error":null,"configuration_version":"cfg_00014"}},"echouee":{"title":"echouee","value":{"request_id":"req_8322","compilation_id":"cmp_01K2QG","status":"failed","draft_revision":43,"created_at":"2026-09-01T10:02:00Z","updated_at":"2026-09-01T10:07:31Z","progress":0.62,"error":{"code":"llm_unavailable","message":"Le service de compilation sémantique est temporairement indisponible."},"configuration_version":null}}},"exampleType":"examples"}},"exampleType":"examples"},"997a47dd-09c0-420d-a55a-0a5e47a7a82a":{"description":"Réponse 401 possible au niveau de l'application. Une clé absente ou invalide est généralement refusée en 403 par la passerelle, sans enveloppe métier garantie.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message","request_id","details"],"description":"Enveloppe uniforme de toutes les erreurs métier.","properties":{"code":{"type":"string","description":"Catalogue fermé des erreurs métier V1.","enum":["unauthorized","insufficient_scope","idempotency_contention","state_version_conflict","idempotency_key_reused","unknown_session","invalid_previous_turn","constraint_no_match","invalid_choice","compiled_artifact_unavailable","configuration_validation_failed","compilation_in_progress","unknown_configuration","unknown_compilation"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"unauthorized","message":"Clé d'intégration absente ou invalide.","request_id":"req_9000","details":{}},"examples":{"Example":{"title":"Example","value":{"code":"unauthorized","message":"Clé d'intégration absente ou invalide.","request_id":"req_9000","details":{}}}},"exampleType":"examples"}},"exampleType":"examples"},"11104a8e-c064-47af-8267-bf13512cd9f7":{"description":"Accès refusé. La passerelle peut renvoyer 403 pour une clé absente, invalide, expirée, révoquée ou dépourvue du scope requis, sans enveloppe métier garantie.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message","request_id","details"],"description":"Enveloppe uniforme de toutes les erreurs métier.","properties":{"code":{"type":"string","description":"Catalogue fermé des erreurs métier V1.","enum":["unauthorized","insufficient_scope","idempotency_contention","state_version_conflict","idempotency_key_reused","unknown_session","invalid_previous_turn","constraint_no_match","invalid_choice","compiled_artifact_unavailable","configuration_validation_failed","compilation_in_progress","unknown_configuration","unknown_compilation"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"insufficient_scope","message":"Cette clé ne permet pas de publier une configuration.","request_id":"req_9001","details":{"required_scopes":["configuration:publish"],"granted_scopes":["configuration:read","configuration:write"]}},"examples":{"Example":{"title":"Example","value":{"code":"insufficient_scope","message":"Cette clé ne permet pas de publier une configuration.","request_id":"req_9001","details":{"required_scopes":["configuration:publish"],"granted_scopes":["configuration:read","configuration:write"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"0287d1d5-4ec3-428a-a092-fc964c95b9fc":{"description":"Job de compilation inconnu, ou appartenant à un autre tenant.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","message","request_id","details"],"description":"Enveloppe uniforme de toutes les erreurs métier.","properties":{"code":{"type":"string","description":"Catalogue fermé des erreurs métier V1.","enum":["unauthorized","insufficient_scope","idempotency_contention","state_version_conflict","idempotency_key_reused","unknown_session","invalid_previous_turn","constraint_no_match","invalid_choice","compiled_artifact_unavailable","configuration_validation_failed","compilation_in_progress","unknown_configuration","unknown_compilation"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"unknown_compilation","message":"Ce job de compilation est inconnu.","request_id":"req_9009","details":{"compilation_id":"cmp_inconnu"}},"examples":{"Example":{"title":"Example","value":{"code":"unknown_compilation","message":"Ce job de compilation est inconnu.","request_id":"req_9009","details":{"compilation_id":"cmp_inconnu"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9a21f59e-73e7-40cb-aed4-69ae805ab1b8":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"Zelinqa API key","description":"Envoyez la clé API dans Authorization: Bearer \u003cclé>. Elle identifie le domaine et les droits autorisés. Ne transmettez pas d'en-têtes d'identité internes.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"1a6b3648-7307-43a6-aa3e-c2fc73c4533a":{"url":"https://api.zelinqa.ai","description":"API publique Zelinqa"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Zelinqa API key","description":"Envoyez la clé API dans Authorization: Bearer \u003cclé>. Elle identifie le domaine et les droits autorisés. Ne transmettez pas d'en-têtes d'identité internes.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Envoyez la clé API dans Authorization: Bearer \u003cclé>. Elle identifie le domaine et les droits autorisés. Ne transmettez pas d'en-têtes d'identité internes.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.fr.yaml"},"subdomain":"zelinqa-d77427f3","siteName":"Zelinqa","title":"Suivre un job de compilation - Zelinqa","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"fr":{"href":"/api-reference/configuration/suivre-un-job-de-compilation","matchLevel":0},"en":{"href":"/en/introduction","matchLevel":4}}},"lastModified":"2026-10-18T22:01:15.296Z","originalFileLocation":"api-reference/configuration/suivre-un-job-de-compilation.mdx","locale":"fr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Renvoie l\u0026#x27;avancement du job : queued, running, succeeded ou failed. En succeeded, configuration_version porte la version désormais active. En failed, error contient une cause bornée et un message lisible : ni trace interne, ni prompt, ni contenu de lot n\u0026#x27;est exposé.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zelinqa\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Suivre un job de compilation - Zelinqa\">\u003cmeta data-mint-head property=\"og:description\" content=\"Renvoie l\u0026#x27;avancement du job : queued, running, succeeded ou failed. En succeeded, configuration_version porte la version désormais active. En failed, error contient une cause bornée et un message lisible : ni trace interne, ni prompt, ni contenu de lot n\u0026#x27;est exposé.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zelinqa\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zelinqa-d77427f3.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Suivre+un+job+de+compilation\u0026amp;description=Renvoie+l%27avancement+du+job+%3A+%60queued%60%2C+%60running%60%2C+%60succeeded%60+ou+%60failed%60.%0A%0AEn+%60succeeded%60%2C+%60configuration_version%60+porte+la+version+d%C3%A9sormais+active.%0AEn+%60fail\u0026amp;theme=2bd94d4ac999925d0fca8b51\u0026amp;signature=0f0e94c3c7e790f5e16ca40528c0cce889195509583943ad50fcb1ac472ee2fd\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Suivre un job de compilation - Zelinqa\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Renvoie l\u0026#x27;avancement du job : queued, running, succeeded ou failed. En succeeded, configuration_version porte la version désormais active. En failed, error contient une cause bornée et un message lisible : ni trace interne, ni prompt, ni contenu de lot n\u0026#x27;est exposé.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zelinqa-d77427f3.mintlify.site/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Suivre+un+job+de+compilation\u0026amp;description=Renvoie+l%27avancement+du+job+%3A+%60queued%60%2C+%60running%60%2C+%60succeeded%60+ou+%60failed%60.%0A%0AEn+%60succeeded%60%2C+%60configuration_version%60+porte+la+version+d%C3%A9sormais+active.%0AEn+%60fail\u0026amp;theme=2bd94d4ac999925d0fca8b51\u0026amp;signature=0f0e94c3c7e790f5e16ca40528c0cce889195509583943ad50fcb1ac472ee2fd\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/zelinqa-d77427f3/DJdTp2ipwe2o2XTM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zelinqa\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C3AED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/configuration/suivre-un-job-de-compilation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.zelinqa.ai/#organization\",\"name\":\"Zelinqa\",\"url\":\"https://docs.zelinqa.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zelinqa-d77427f3/NHQX6jXz7QClMoqF/logo/light.svg?fit=max\u0026auto=format\u0026n=NHQX6jXz7QClMoqF\u0026q=85\u0026s=6cbe3336a207008182be0916b85b70ef\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zelinqa.ai#website\",\"name\":\"Zelinqa\",\"url\":\"https://docs.zelinqa.ai\",\"publisher\":{\"@id\":\"https://docs.zelinqa.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation#webpage\",\"url\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation\",\"name\":\"Suivre un job de compilation\",\"description\":\"Renvoie l'avancement du job : queued, running, succeeded ou failed. En succeeded, configuration_version porte la version désormais active. En failed, error contient une cause bornée et un message lisible : ni trace interne, ni prompt, ni contenu de lot n'est exposé.\",\"dateModified\":\"2026-10-18T22:01:15.296Z\",\"isPartOf\":{\"@id\":\"https://docs.zelinqa.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configuration\",\"item\":\"https://docs.zelinqa.ai/api-reference/configuration/lire-la-configuration-%C3%A9ditoriale\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Suivre un job de compilation\",\"item\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation#apireference\",\"headline\":\"Suivre un job de compilation\",\"name\":\"Suivre un job de compilation\",\"description\":\"Renvoie l'avancement du job : queued, running, succeeded ou failed. En succeeded, configuration_version porte la version désormais active. En failed, error contient une cause bornée et un message lisible : ni trace interne, ni prompt, ni contenu de lot n'est exposé.\",\"url\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zelinqa.ai/api-reference/configuration/suivre-un-job-de-compilation#webpage\"},\"dateModified\":\"2026-10-18T22:01:15.296Z\",\"publisher\":{\"@id\":\"https://docs.zelinqa.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zelinqa.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zelinqa\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Zelinqa\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/configuration/suivre-un-job-de-compilation.md","siteName":"Zelinqa","nav":{"global":null,"languages":[{"language":"fr","default":true,"tabs":[{"tab":"Développeurs","pages":[{"title":"Développeurs","href":"/fr/introduction"}]},{"tab":"Zelinqa Studio","pages":[{"title":"Zelinqa Studio","href":"/fr/studio/overview"}]},{"tab":"Référence API","groups":[{"group":"Guides API","pages":[{"title":"Référence API V1","href":"/fr/api-reference/overview"},{"title":"Authentification, idempotence et concurrence","href":"/fr/api-reference/auth-concurrency"},{"title":"Intégration REST","href":"/fr/integrations/rest-api"},{"title":"Appels HTTP avec curl","href":"/fr/quickstart/first-api-call"},{"title":"Erreurs","href":"/fr/api-reference/errors"}]},{"group":"Sessions","pages":[{"title":"Créer une session","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml post /v1/sessions","href":"/api-reference/sessions/créer-une-session"},{"title":"Comprendre le tour précédent et proposer les questions suivantes","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml post /v1/sessions/{session_id}/next","href":"/api-reference/sessions/comprendre-le-tour-précédent-et-proposer-les-questions-suivantes"},{"title":"Appliquer un contexte ou une mise à jour sans consommer de tour","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml post /v1/sessions/{session_id}/events","href":"/api-reference/sessions/appliquer-un-contexte-ou-une-mise-à-jour-sans-consommer-de-tour"},{"title":"Lire l'état public d'une session","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/sessions/{session_id}","href":"/api-reference/sessions/lire-létat-public-dune-session"},{"title":"Déclarer le résultat réel de la conversation","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml post /v1/sessions/{session_id}/feedback","href":"/api-reference/sessions/déclarer-le-résultat-réel-de-la-conversation"}]},{"group":"Configuration","pages":[{"title":"Lire la configuration éditoriale","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/configuration","href":"/api-reference/configuration/lire-la-configuration-éditoriale"},{"title":"Lister les questions","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/configuration/questions","href":"/api-reference/configuration/lister-les-questions"},{"title":"Consulter le journal des changements","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/configuration/audit","href":"/api-reference/configuration/consulter-le-journal-des-changements"},{"title":"Appliquer des changements au brouillon","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml post /v1/configuration/changes","href":"/api-reference/configuration/appliquer-des-changements-au-brouillon"},{"title":"Publier le brouillon","description":"Valide le brouillon, crée un job de compilation et retourne immédiatement\n`202 Accepted`. La compilation ne s'exécute **jamais** dans la requête HTTP :\nun corpus important demande plusieurs lots LLM, bien au-delà de la limite de\nla passerelle.\n\nLe brouillon ne devient la configuration active qu'à la fin de la\ncompilation. Une ancienne version compilée reste lisible pour terminer les\nsessions qui l'utilisent déjà.\n\nUn second publish du même domaine alors qu'un job est `queued` ou `running`\nretourne `409 compilation_in_progress` avec le `compilation_id` en cours.\n\nSuivre l'avancement avec\n`GET /v1/configuration/compilations/{compilation_id}`.\n","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml post /v1/configuration/publish","href":"/api-reference/configuration/publier-le-brouillon"},{"title":"Suivre un job de compilation","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/configuration/compilations/{compilation_id}","href":"/api-reference/configuration/suivre-un-job-de-compilation"}]},{"group":"Service","pages":[{"title":"Sonde de disponibilité","description":"Route publique sans authentification. Ne renvoie aucune donnée de tenant.\n","deprecated":null,"version":null,"openapi":"/openapi.fr.yaml get /v1/health","href":"/api-reference/legacy/sonde-de-disponibilité"}]}]}]},{"language":"en","pages":[{"title":"en","href":"/en/introduction"}]}]},"basePath":"","title":"Suivre un job de compilation - Zelinqa","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}