{ "openapi": "3.1.1", "info": { "title": "Docula API", "version": "0.8.0", "description": "The authenticated Docula foundation, authoring, immutable-release, durable execution, live trace, verified artifact download, and audit API. Static application and changelog pages are outside this API contract. Browser authentication is host-aware across the separately configured exact business and operational origins.", "x-docula-documentation": { "schema": "docula.openapi-documentation/v1", "extensions": { "x-docula-summary-ro": { "type": "string", "purpose": "Canonical Romanian operation summary." }, "x-docula-description-ro": { "type": "string", "purpose": "Canonical Romanian operation description." }, "x-docula-roles": { "type": "array", "items": "role", "purpose": "Allowed role set after authentication." }, "x-docula-required-headers": { "type": "array", "items": "header-name", "purpose": "Resolved required request headers." }, "x-docula-limits": { "type": "object", "purpose": "Resolved body and parameter bounds; null means not applicable." } } } }, "servers": [ { "url": "https://docula.ro", "description": "Canonical staging API through the docula.ro same-origin ingress" }, { "url": "http://127.0.0.1:18081", "description": "Loopback development" } ], "x-docula-unmatched-api": { "status": 404, "code": "not_found", "description": "Every unknown API or health path returns the RFC 9457 problem response NotFound." }, "paths": { "/health/live": { "get": { "operationId": "getLiveness", "summary": "Report process liveness and build identity", "description": "This operation never calls a dependency.", "security": [], "responses": { "200": { "$ref": "#/components/responses/LiveOK" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" } }, "tags": [ "Health" ], "x-docula-summary-ro": "Verifică funcționarea procesului și identitatea versiunii", "x-docula-description-ro": "Operația nu interoghează nicio dependență.", "x-docula-roles": [ "public" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the limits convention for getLiveness.", "url": "/developers/api#limits" } } }, "/health/ready": { "get": { "operationId": "getReadiness", "summary": "Report aggregate dependency readiness", "description": "Returns only safe PostgreSQL, NATS, and S3 names and aggregate statuses.", "security": [], "responses": { "200": { "$ref": "#/components/responses/PublicReadinessOK" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Health" ], "x-docula-summary-ro": "Verifică disponibilitatea cumulată a dependențelor", "x-docula-description-ro": "Returnează numai numele sigure și stările cumulate pentru PostgreSQL, NATS și S3.", "x-docula-roles": [ "public" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the limits convention for getReadiness.", "url": "/developers/api#limits" } } }, "/api/v1/auth/login": { "post": { "operationId": "login", "summary": "Create a server-side session", "description": "Requires one configured exact Origin whose host equals the request Host, or one same-origin Referer only when Origin is absent. The JSON body is bounded to 8192 bytes.", "security": [], "x-docula-body-limit": 8192, "parameters": [ { "$ref": "#/components/parameters/Origin" }, { "$ref": "#/components/parameters/Referer" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" }, "examples": { "synthetic": { "summary": "Synthetic login request", "value": { "username": "synthetic-example", "password": "synthetic-example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/LoginOK" }, "401": { "$ref": "#/components/responses/InvalidCredentials" }, "403": { "$ref": "#/components/responses/OriginRejected" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Authentication" ], "x-docula-summary-ro": "Creează o sesiune pe server", "x-docula-description-ro": "Necesită un Origin exact configurat sau, numai în lipsa lui, un Referer de aceeași origine. Corpul JSON este limitat la 8192 de octeți.", "x-docula-roles": [ "public" ], "x-docula-required-headers": [ "Content-Type" ], "x-docula-limits": { "body_bytes": 8192, "parameters": [] }, "externalDocs": { "description": "Read the authentication convention for login.", "url": "/developers/api#authentication" } } }, "/api/v1/auth/session": { "get": { "operationId": "getCurrentSession", "summary": "Read the current server-side session", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/SessionOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Authentication" ], "description": "Read the current server-side session. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 405, 500, 503. Use the host-local session rules, including password rotation and logout behavior.", "x-docula-summary-ro": "Citește sesiunea curentă de pe server", "x-docula-description-ro": "Citește sesiunea curentă de pe server. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 405, 500, 503. Aplică regulile sesiunii locale domeniului, inclusiv schimbarea parolei și deconectarea.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the authentication convention for getCurrentSession.", "url": "/developers/api#authentication" } } }, "/api/v1/auth/password": { "post": { "operationId": "changePassword", "summary": "Change the current user's password", "description": "Requires a valid host-only session, one configured exact Origin whose host equals the request Host, and the per-session CSRF token. Success revokes every session and expires the cookie. The JSON body is bounded to 8192 bytes.", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 8192, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PasswordChangeRequest" }, "examples": { "synthetic": { "summary": "Synthetic changePassword request", "value": { "current_password": "synthetic-example", "new_password": "synthetic-example" } } } } } }, "responses": { "204": { "$ref": "#/components/responses/PasswordChanged" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/CSRFRejected" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Authentication" ], "x-docula-summary-ro": "Schimbă parola utilizatorului curent", "x-docula-description-ro": "Necesită o sesiune locală domeniului, un Origin exact și tokenul CSRF al sesiunii. La succes revocă toate sesiunile și expiră cookie-ul.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 8192, "parameters": [] }, "externalDocs": { "description": "Read the authentication convention for changePassword.", "url": "/developers/api#authentication" } } }, "/api/v1/auth/logout": { "post": { "operationId": "logout", "summary": "Revoke the current session", "description": "Requires Content-Type application/json and a zero-byte entity body, plus a valid host-only session, one configured exact Origin whose host equals the request Host, and the per-session CSRF token.", "security": [ { "sessionCookie": [] } ], "x-docula-content-type-required": "application/json", "x-docula-empty-body": true, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "responses": { "204": { "$ref": "#/components/responses/LoggedOut" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/CSRFRejected" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Authentication" ], "x-docula-summary-ro": "Închide sesiunea curentă", "x-docula-description-ro": "Necesită Content-Type application/json, corp gol, sesiune validă, Origin exact și tokenul CSRF al sesiunii.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the authentication convention for logout.", "url": "/developers/api#authentication" } } }, "/api/v1/admin/readiness": { "get": { "operationId": "getDetailedReadiness", "summary": "Read administrator-only dependency details", "description": "NATS or S3 failures are represented in a successful response. A 503 means PostgreSQL prevented session or authorization evaluation.", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/AdminReadinessOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Administration" ], "x-docula-summary-ro": "Citește starea detaliată a dependențelor pentru administrator", "x-docula-description-ro": "Defecțiunile NATS sau S3 apar într-un răspuns reușit; 503 indică imposibilitatea evaluării sesiunii prin PostgreSQL.", "x-docula-roles": [ "administrator" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the authorization convention for getDetailedReadiness.", "url": "/developers/api#authorization" } } }, "/api/v1/contracts": { "get": { "operationId": "listContracts", "summary": "List contracts visible to the current role", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/ContractListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "List contracts visible to the current role. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Listează contractele vizibile rolului curent", "x-docula-description-ro": "Listează contractele vizibile rolului curent. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for listContracts.", "url": "/developers/api#versions" } }, "post": { "operationId": "createContract", "summary": "Create a mutable contract draft", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1085440, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateContractRequest" }, "examples": { "synthetic": { "summary": "Synthetic createContract request", "value": { "name": "synthetic-example", "description": "synthetic-example", "schema": "synthetic-example" } } } } } }, "responses": { "201": { "$ref": "#/components/responses/ContractCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/ContractMutationDenied" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "Create a mutable contract draft. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, request body. HTTP success: 201; documented failures: 401, 403, 405, 409, 415, 422, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Creează o ciornă editabilă de contract", "x-docula-description-ro": "Creează o ciornă editabilă de contract. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, request body. Succes HTTP: 201; erori documentate: 401, 403, 405, 409, 415, 422, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1085440, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for createContract.", "url": "/developers/api#versions" } } }, "/api/v1/contracts/{contractId}": { "get": { "operationId": "getContract", "summary": "Read a contract and its visible immutable versions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ContractID" } ], "responses": { "200": { "$ref": "#/components/responses/ContractOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "Read a contract and its visible immutable versions. Reads the identified resource without mutation. Required inputs: contractId. HTTP success: 200; documented failures: 401, 403, 404, 405, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Citește un contract și versiunile sale imuabile vizibile", "x-docula-description-ro": "Citește un contract și versiunile sale imuabile vizibile. Citește resursa identificată fără modificare. Intrări obligatorii: contractId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for getContract.", "url": "/developers/api#versions" } }, "put": { "operationId": "updateContractDraft", "summary": "Update a contract draft using optimistic concurrency", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1085440, "parameters": [ { "$ref": "#/components/parameters/ContractID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateContractRequest" }, "examples": { "synthetic": { "summary": "Synthetic updateContractDraft request", "value": { "name": "synthetic-example", "description": "synthetic-example", "schema": "synthetic-example", "expected_revision": 1 } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ContractUpdated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/ContractMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "Update a contract draft using optimistic concurrency. Applies the documented change under the declared preconditions. Required inputs: contractId, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Actualizează o ciornă de contract cu verificarea reviziei", "x-docula-description-ro": "Actualizează o ciornă de contract cu verificarea reviziei. Aplică modificarea documentată cu precondițiile declarate. Intrări obligatorii: contractId, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1085440, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for updateContractDraft.", "url": "/developers/api#versions" } } }, "/api/v1/contracts/{contractId}/validate": { "post": { "operationId": "validateContractDraft", "summary": "Validate JSON Schema Draft 2020-12 content", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1085440, "parameters": [ { "$ref": "#/components/parameters/ContractID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateContractRequest" }, "examples": { "synthetic": { "summary": "Synthetic validateContractDraft request", "value": { "schema": "synthetic-example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ContractValidationOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/ContractMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "Validate JSON Schema Draft 2020-12 content. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: contractId, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Validează conținutul JSON Schema Draft 2020-12", "x-docula-description-ro": "Validează conținutul JSON Schema Draft 2020-12. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: contractId, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1085440, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for validateContractDraft.", "url": "/developers/api#versions" } } }, "/api/v1/contracts/{contractId}/versions": { "post": { "operationId": "createContractVersion", "summary": "Create a sequential immutable contract version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ContractID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevisionRequest" }, "examples": { "synthetic": { "summary": "Synthetic createContractVersion request", "value": { "expected_revision": 1 } } } } } }, "responses": { "201": { "$ref": "#/components/responses/VersionCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/ContractMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "Create a sequential immutable contract version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: contractId, Origin, X-CSRF-Token, request body. HTTP success: 201; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Creează următoarea versiune imuabilă a contractului", "x-docula-description-ro": "Creează următoarea versiune imuabilă a contractului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: contractId, Origin, X-CSRF-Token, request body. Succes HTTP: 201; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for createContractVersion.", "url": "/developers/api#versions" } } }, "/api/v1/contracts/{contractId}/versions/{versionNumber}/publish": { "post": { "operationId": "publishContractVersion", "summary": "Publish an immutable contract version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ContractID" }, { "$ref": "#/components/parameters/VersionNumber" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic publishContractVersion request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/VersionUpdated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/ContractMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "Publish an immutable contract version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: contractId, versionNumber, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Publică o versiune imuabilă a contractului", "x-docula-description-ro": "Publică o versiune imuabilă a contractului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: contractId, versionNumber, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for publishContractVersion.", "url": "/developers/api#versions" } } }, "/api/v1/contracts/{contractId}/versions/{versionNumber}/deprecate": { "post": { "operationId": "deprecateContractVersion", "summary": "Deprecate a published immutable contract version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ContractID" }, { "$ref": "#/components/parameters/VersionNumber" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic deprecateContractVersion request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/VersionUpdated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/ContractMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Contracts" ], "description": "Deprecate a published immutable contract version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: contractId, versionNumber, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Preserve draft revision, immutable version, publication, and deprecation identities.", "x-docula-summary-ro": "Retrage o versiune publicată și imuabilă a contractului", "x-docula-description-ro": "Retrage o versiune publicată și imuabilă a contractului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: contractId, versionNumber, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Păstrează identitățile ciornei, versiunii imuabile, publicării și retragerii.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the versions convention for deprecateContractVersion.", "url": "/developers/api#versions" } } }, "/api/v1/cases": { "get": { "operationId": "listCases", "summary": "List deterministic cases and immutable provenance", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/CaseListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Cases" ], "description": "List deterministic cases and immutable provenance. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează cazurile deterministe și proveniența lor imuabilă", "x-docula-description-ro": "Listează cazurile deterministe și proveniența lor imuabilă. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listCases.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/cases/generate": { "post": { "operationId": "generateCase", "summary": "Generate and persist a deterministic case from a published contract version", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 8192, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateCaseRequest" }, "examples": { "synthetic": { "summary": "Synthetic generateCase request", "value": { "contract_version_id": "11111111-1111-4111-8111-111111111111", "kind": "valid", "seed": 0 } } } } } }, "responses": { "201": { "$ref": "#/components/responses/CaseCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/CaseMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Cases" ], "description": "Generate and persist a deterministic case from a published contract version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, request body. HTTP success: 201; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Generează și salvează un caz determinist dintr-o versiune publicată", "x-docula-description-ro": "Generează și salvează un caz determinist dintr-o versiune publicată. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, request body. Succes HTTP: 201; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 8192, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for generateCase.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/cases/import": { "post": { "operationId": "importFixtureCase", "summary": "Validate and idempotently import a canonical fixture case", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 532480, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportCaseRequest" }, "examples": { "synthetic": { "summary": "Synthetic importFixtureCase request", "value": { "contract_version_id": "11111111-1111-4111-8111-111111111111", "kind": "valid", "payload": "synthetic-example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/CaseOK" }, "201": { "$ref": "#/components/responses/CaseCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/CaseMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Cases" ], "description": "Validate and idempotently import a canonical fixture case. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Validează și importă idempotent un caz canonic de test", "x-docula-description-ro": "Validează și importă idempotent un caz canonic de test. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 532480, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for importFixtureCase.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/cases/{caseId}": { "get": { "operationId": "getCase", "summary": "Read a deterministic case payload and immutable provenance", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/CaseID" } ], "responses": { "200": { "$ref": "#/components/responses/CaseOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Cases" ], "description": "Read a deterministic case payload and immutable provenance. Reads the identified resource without mutation. Required inputs: caseId. HTTP success: 200; documented failures: 401, 403, 404, 405, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește datele și proveniența imuabilă ale unui caz determinist", "x-docula-description-ro": "Citește datele și proveniența imuabilă ale unui caz determinist. Citește resursa identificată fără modificare. Intrări obligatorii: caseId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getCase.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/ingestion-models": { "get": { "operationId": "listIngestionModels", "summary": "List bounded canonical ingestion-model families", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/IngestionModelListOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "List bounded canonical ingestion-model families. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează familiile canonice de modele de ingestie", "x-docula-description-ro": "Listează familiile canonice de modele de ingestie. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listIngestionModels.", "url": "/developers/api#configuration-lifecycle" } }, "post": { "operationId": "createIngestionModel", "summary": "Create a revisioned canonical ingestion-model family", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestionModelCreateRequest" }, "examples": { "synthetic": { "summary": "Synthetic createIngestionModel request", "value": { "slug": "synthetic-example", "name": "synthetic-example", "definition": {}, "contract_version_id": "11111111-1111-4111-8111-111111111111", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/ConfigurationMutationCreated" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Create a revisioned canonical ingestion-model family. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 201; documented failures: 401, 403, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Creează o familie revizionată de modele de ingestie", "x-docula-description-ro": "Creează o familie revizionată de modele de ingestie. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for createIngestionModel.", "url": "/developers/api#idempotency" } } }, "/api/v1/ingestion-models/by-slug/{ingestionModelSlug}": { "get": { "operationId": "getIngestionModelBySlug", "summary": "Read one canonical ingestion-model family by exact slug", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "ingestionModelSlug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 64 }, "example": "synthetic-example", "description": "Exact canonical ingestion-model slug.", "x-docula-description-ro": "Slugul exact al modelului canonic de ingestie." } ], "responses": { "200": { "$ref": "#/components/responses/IngestionModelOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Read one canonical ingestion-model family by exact slug. Reads the identified resource without mutation. Required inputs: ingestionModelSlug. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește familia modelului de ingestie după identificatorul textual exact", "x-docula-description-ro": "Citește familia modelului de ingestie după identificatorul textual exact. Citește resursa identificată fără modificare. Intrări obligatorii: ingestionModelSlug. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "ingestionModelSlug", "maximum": null, "max_length": 64 } ] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getIngestionModelBySlug.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/ingestion-models/{ingestionModelId}": { "get": { "operationId": "getIngestionModel", "summary": "Read one canonical ingestion-model family", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" } ], "responses": { "200": { "$ref": "#/components/responses/IngestionModelOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Read one canonical ingestion-model family. Reads the identified resource without mutation. Required inputs: ingestionModelId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește o familie canonică de modele de ingestie", "x-docula-description-ro": "Citește o familie canonică de modele de ingestie. Citește resursa identificată fără modificare. Intrări obligatorii: ingestionModelId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getIngestionModel.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/ingestion-models/{ingestionModelId}/draft": { "get": { "operationId": "getIngestionModelDraft", "summary": "Read the revisioned ingestion-model draft", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" } ], "responses": { "200": { "$ref": "#/components/responses/IngestionModelDraftOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Read the revisioned ingestion-model draft. Reads the identified resource without mutation. Required inputs: ingestionModelId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește ciorna revizionată a modelului de ingestie", "x-docula-description-ro": "Citește ciorna revizionată a modelului de ingestie. Citește resursa identificată fără modificare. Intrări obligatorii: ingestionModelId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getIngestionModelDraft.", "url": "/developers/api#configuration-lifecycle" } }, "patch": { "operationId": "updateIngestionModelDraft", "summary": "Replace an ingestion-model draft under a strong revision precondition", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/IfMatchRevision" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestionModelDraftUpdateRequest" }, "examples": { "synthetic": { "summary": "Synthetic updateIngestionModelDraft request", "value": { "name": "synthetic-example", "definition": {}, "contract_version_id": "11111111-1111-4111-8111-111111111111", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "412": { "$ref": "#/components/responses/ConfigurationPreconditionFailed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "428": { "$ref": "#/components/responses/ConfigurationPreconditionRequired" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Replace an ingestion-model draft under a strong revision precondition. Applies the documented change under the declared preconditions. Required inputs: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Send the current strong revision precondition and recover explicitly from stale writes.", "x-docula-summary-ro": "Înlocuiește ciorna modelului de ingestie cu verificarea reviziei", "x-docula-description-ro": "Înlocuiește ciorna modelului de ingestie cu verificarea reviziei. Aplică modificarea documentată cu precondițiile declarate. Intrări obligatorii: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Trimite precondiția puternică a reviziei curente și recuperează explicit după o scriere învechită.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "If-Match", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the concurrency convention for updateIngestionModelDraft.", "url": "/developers/api#concurrency" } } }, "/api/v1/ingestion-models/{ingestionModelId}/versions": { "get": { "operationId": "listIngestionModelVersions", "summary": "List bounded immutable ingestion-model versions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" } ], "responses": { "200": { "$ref": "#/components/responses/IngestionModelVersionsOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "List bounded immutable ingestion-model versions. Reads the identified resource without mutation. Required inputs: ingestionModelId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează versiunile imuabile ale modelului de ingestie", "x-docula-description-ro": "Listează versiunile imuabile ale modelului de ingestie. Citește resursa identificată fără modificare. Intrări obligatorii: ingestionModelId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listIngestionModelVersions.", "url": "/developers/api#configuration-lifecycle" } }, "post": { "operationId": "versionIngestionModel", "summary": "Freeze the exact ingestion-model draft revision as an immutable version", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/IfMatchRevision" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic versionIngestionModel request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/ConfigurationMutationCreated" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "412": { "$ref": "#/components/responses/ConfigurationPreconditionFailed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "428": { "$ref": "#/components/responses/ConfigurationPreconditionRequired" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Freeze the exact ingestion-model draft revision as an immutable version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Send the current strong revision precondition and recover explicitly from stale writes.", "x-docula-summary-ro": "Fixează revizia exactă a modelului de ingestie ca versiune imuabilă", "x-docula-description-ro": "Fixează revizia exactă a modelului de ingestie ca versiune imuabilă. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Trimite precondiția puternică a reviziei curente și recuperează explicit după o scriere învechită.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "If-Match", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the concurrency convention for versionIngestionModel.", "url": "/developers/api#concurrency" } } }, "/api/v1/ingestion-models/{ingestionModelId}/versions:resolve": { "get": { "operationId": "resolveIngestionModelVersion", "summary": "Resolve the ingestion-model activation at official object time", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" }, { "$ref": "#/components/parameters/AsOf" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationActivationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Resolve the ingestion-model activation at official object time. Reads the identified resource without mutation. Required inputs: ingestionModelId, at. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Rezolvă activarea modelului la momentul oficial al obiectului", "x-docula-description-ro": "Rezolvă activarea modelului la momentul oficial al obiectului. Citește resursa identificată fără modificare. Intrări obligatorii: ingestionModelId, at. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for resolveIngestionModelVersion.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/ingestion-models/{ingestionModelId}/activations": { "get": { "operationId": "listIngestionModelActivations", "summary": "List bounded ingestion-model activation history", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationActivationsOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "List bounded ingestion-model activation history. Reads the identified resource without mutation. Required inputs: ingestionModelId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează istoricul activărilor modelului de ingestie", "x-docula-description-ro": "Listează istoricul activărilor modelului de ingestie. Citește resursa identificată fără modificare. Intrări obligatorii: ingestionModelId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listIngestionModelActivations.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/ingestion-models/{ingestionModelId}/validate": { "post": { "operationId": "validateIngestionModel", "summary": "Validate an ingestion-model definition and sample without canonical writes", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestionModelValidationRequest" }, "examples": { "synthetic": { "summary": "Synthetic validateIngestionModel request", "value": { "definition": {}, "contract_version_id": "11111111-1111-4111-8111-111111111111", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "sample": { "metadata": { "model_slug": "synthetic-example", "object_reference": "synthetic-example", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "payload": "synthetic-example" } } } } } } }, "responses": { "200": { "$ref": "#/components/responses/IngestionModelValidationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Validate an ingestion-model definition and sample without canonical writes. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Validează definiția și exemplul modelului fără scrieri canonice", "x-docula-description-ro": "Validează definiția și exemplul modelului fără scrieri canonice. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for validateIngestionModel.", "url": "/developers/api#idempotency" } } }, "/api/v1/ingestion-models/{ingestionModelId}/test": { "post": { "operationId": "testIngestionModel", "summary": "Test the exact stored ingestion-model draft and sample without canonical writes", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestionModelTestRequest" }, "examples": { "synthetic": { "summary": "Synthetic testIngestionModel request", "value": { "sample": { "metadata": { "model_slug": "synthetic-example", "object_reference": "synthetic-example", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "payload": "synthetic-example" } } } } } } }, "responses": { "200": { "$ref": "#/components/responses/IngestionModelValidationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Test the exact stored ingestion-model draft and sample without canonical writes. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Testează ciorna salvată a modelului fără scrieri canonice", "x-docula-description-ro": "Testează ciorna salvată a modelului fără scrieri canonice. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: ingestionModelId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for testIngestionModel.", "url": "/developers/api#idempotency" } } }, "/api/v1/ingestion-models/{ingestionModelId}/versions/{versionNumber}/publish": { "post": { "operationId": "publishIngestionModelVersionCalendar", "summary": "Atomically publish and schedule an immutable ingestion-model version", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" }, { "$ref": "#/components/parameters/VersionNumber" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationPublicationRequest" }, "examples": { "synthetic": { "summary": "Synthetic publishIngestionModelVersionCalendar request", "value": { "effective_from": "2026-08-01T10:00:00Z" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/ConfigurationMutationCreated" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Atomically publish and schedule an immutable ingestion-model version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: ingestionModelId, versionNumber, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Publică și programează atomic o versiune imuabilă a modelului", "x-docula-description-ro": "Publică și programează atomic o versiune imuabilă a modelului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: ingestionModelId, versionNumber, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for publishIngestionModelVersionCalendar.", "url": "/developers/api#idempotency" } } }, "/api/v1/ingestion-models/{ingestionModelId}/activations/{activationId}/cancel": { "post": { "operationId": "cancelIngestionModelActivation", "summary": "Cancel a future unpinned ingestion-model activation", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/IngestionModelID" }, { "$ref": "#/components/parameters/ActivationID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationCancellationRequest" }, "examples": { "synthetic": { "summary": "Synthetic cancelIngestionModelActivation request", "value": { "reason_code": "synthetic_example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Ingestion models" ], "description": "Cancel a future unpinned ingestion-model activation. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: ingestionModelId, activationId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Anulează o activare viitoare nefixată a modelului de ingestie", "x-docula-description-ro": "Anulează o activare viitoare nefixată a modelului de ingestie. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: ingestionModelId, activationId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for cancelIngestionModelActivation.", "url": "/developers/api#idempotency" } } }, "/api/v1/transformers": { "get": { "operationId": "listCanonicalTransformers", "summary": "List bounded canonical transformer families", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/RegistryLimit" }, { "$ref": "#/components/parameters/RegistryCursor" } ], "responses": { "200": { "$ref": "#/components/responses/CanonicalTransformerListOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "List bounded canonical transformer families. Reads a bounded canonical view without mutation. Optional limit and opaque cursor select a stable page; no request body applies. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve it exactly for the next page.", "x-docula-summary-ro": "Listează familiile canonice de transformatoare", "x-docula-description-ro": "Listează familiile canonice de transformatoare. Citește o pagină stabilă folosind limita opțională și cursorul opac; nu acceptă body. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează-l exact pentru pagina următoare.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 256 } ] }, "externalDocs": { "description": "Read the pagination convention for listCanonicalTransformers.", "url": "/developers/api#pagination" } }, "post": { "operationId": "createCanonicalTransformer", "summary": "Create a revisioned canonical transformer family", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTransformerCreateRequest" }, "examples": { "synthetic": { "summary": "Synthetic createCanonicalTransformer request", "value": { "slug": "synthetic-example", "name": "synthetic-example", "source": "synthetic-example", "format": "yaml" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/ConfigurationMutationCreated" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Create a revisioned canonical transformer family. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 201; documented failures: 401, 403, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Creează o familie revizionată de transformatoare canonice", "x-docula-description-ro": "Creează o familie revizionată de transformatoare canonice. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for createCanonicalTransformer.", "url": "/developers/api#idempotency" } } }, "/api/v1/transformers/{transformerId}": { "get": { "operationId": "getCanonicalTransformer", "summary": "Read one canonical transformer family", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformerID" } ], "responses": { "200": { "$ref": "#/components/responses/CanonicalTransformerOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Read one canonical transformer family. Reads the identified resource without mutation. Required inputs: transformerId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește o familie canonică de transformatoare", "x-docula-description-ro": "Citește o familie canonică de transformatoare. Citește resursa identificată fără modificare. Intrări obligatorii: transformerId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getCanonicalTransformer.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transformers/{transformerId}/draft": { "get": { "operationId": "getCanonicalTransformerDraft", "summary": "Read the revisioned canonical transformer draft", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformerID" } ], "responses": { "200": { "$ref": "#/components/responses/CanonicalTransformerDraftOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Read the revisioned canonical transformer draft. Reads the identified resource without mutation. Required inputs: transformerId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește ciorna revizionată a transformatorului canonic", "x-docula-description-ro": "Citește ciorna revizionată a transformatorului canonic. Citește resursa identificată fără modificare. Intrări obligatorii: transformerId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getCanonicalTransformerDraft.", "url": "/developers/api#configuration-lifecycle" } }, "patch": { "operationId": "updateCanonicalTransformerDraft", "summary": "Replace a transformer draft under a strong revision precondition", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/TransformerID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/IfMatchRevision" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTransformerDraftUpdateRequest" }, "examples": { "synthetic": { "summary": "Synthetic updateCanonicalTransformerDraft request", "value": { "name": "synthetic-example", "source": "synthetic-example", "format": "yaml" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "412": { "$ref": "#/components/responses/ConfigurationPreconditionFailed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "428": { "$ref": "#/components/responses/ConfigurationPreconditionRequired" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Replace a transformer draft under a strong revision precondition. Applies the documented change under the declared preconditions. Required inputs: transformerId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Send the current strong revision precondition and recover explicitly from stale writes.", "x-docula-summary-ro": "Înlocuiește ciorna transformatorului cu verificarea reviziei", "x-docula-description-ro": "Înlocuiește ciorna transformatorului cu verificarea reviziei. Aplică modificarea documentată cu precondițiile declarate. Intrări obligatorii: transformerId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Trimite precondiția puternică a reviziei curente și recuperează explicit după o scriere învechită.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "If-Match", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the concurrency convention for updateCanonicalTransformerDraft.", "url": "/developers/api#concurrency" } } }, "/api/v1/transformers/{transformerId}/versions": { "get": { "operationId": "listCanonicalTransformerVersions", "summary": "List bounded immutable transformer versions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformerID" } ], "responses": { "200": { "$ref": "#/components/responses/CanonicalTransformerVersionsOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "List bounded immutable transformer versions. Reads the identified resource without mutation. Required inputs: transformerId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează versiunile imuabile ale transformatorului", "x-docula-description-ro": "Listează versiunile imuabile ale transformatorului. Citește resursa identificată fără modificare. Intrări obligatorii: transformerId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listCanonicalTransformerVersions.", "url": "/developers/api#configuration-lifecycle" } }, "post": { "operationId": "versionCanonicalTransformer", "summary": "Freeze the exact transformer draft revision as an immutable version", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/TransformerID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/IfMatchRevision" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic versionCanonicalTransformer request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/ConfigurationMutationCreated" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "412": { "$ref": "#/components/responses/ConfigurationPreconditionFailed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "428": { "$ref": "#/components/responses/ConfigurationPreconditionRequired" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Freeze the exact transformer draft revision as an immutable version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformerId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Send the current strong revision precondition and recover explicitly from stale writes.", "x-docula-summary-ro": "Fixează revizia exactă a transformatorului ca versiune imuabilă", "x-docula-description-ro": "Fixează revizia exactă a transformatorului ca versiune imuabilă. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformerId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Trimite precondiția puternică a reviziei curente și recuperează explicit după o scriere învechită.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "If-Match", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the concurrency convention for versionCanonicalTransformer.", "url": "/developers/api#concurrency" } } }, "/api/v1/transformers/{transformerId}/versions:resolve": { "get": { "operationId": "resolveCanonicalTransformerVersion", "summary": "Resolve the transformer activation at official object time", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformerID" }, { "$ref": "#/components/parameters/AsOf" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationActivationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Resolve the transformer activation at official object time. Reads the identified resource without mutation. Required inputs: transformerId, at. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Rezolvă activarea transformatorului la momentul oficial al obiectului", "x-docula-description-ro": "Rezolvă activarea transformatorului la momentul oficial al obiectului. Citește resursa identificată fără modificare. Intrări obligatorii: transformerId, at. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for resolveCanonicalTransformerVersion.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transformers/{transformerId}/activations": { "get": { "operationId": "listCanonicalTransformerActivations", "summary": "List bounded transformer activation history", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformerID" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationActivationsOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "List bounded transformer activation history. Reads the identified resource without mutation. Required inputs: transformerId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează istoricul activărilor transformatorului", "x-docula-description-ro": "Listează istoricul activărilor transformatorului. Citește resursa identificată fără modificare. Intrări obligatorii: transformerId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listCanonicalTransformerActivations.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transformers/{transformerId}/validate": { "post": { "operationId": "validateCanonicalTransformer", "summary": "Validate declarative-v1 source without canonical writes", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/TransformerID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTransformerValidationRequest" }, "examples": { "synthetic": { "summary": "Synthetic validateCanonicalTransformer request", "value": { "source": "synthetic-example", "format": "yaml" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationValidationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Validate declarative-v1 source without canonical writes. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformerId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Validează sursa declarative-v1 fără scrieri canonice", "x-docula-description-ro": "Validează sursa declarative-v1 fără scrieri canonice. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformerId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for validateCanonicalTransformer.", "url": "/developers/api#idempotency" } } }, "/api/v1/transformers/{transformerId}/test": { "post": { "operationId": "testCanonicalTransformer", "summary": "Execute declarative-v1 deterministically without canonical writes", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/TransformerID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTransformerTestRequest" }, "examples": { "synthetic": { "summary": "Synthetic testCanonicalTransformer request", "value": { "source": "synthetic-example", "format": "yaml", "input": "synthetic-example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/CanonicalTransformerTestOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Execute declarative-v1 deterministically without canonical writes. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformerId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Execută deterministic sursa declarative-v1 fără scrieri canonice", "x-docula-description-ro": "Execută deterministic sursa declarative-v1 fără scrieri canonice. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformerId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for testCanonicalTransformer.", "url": "/developers/api#idempotency" } } }, "/api/v1/transformers/{transformerId}/versions/{versionNumber}/publish": { "post": { "operationId": "publishCanonicalTransformerVersion", "summary": "Atomically publish and schedule an immutable transformer version", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/TransformerID" }, { "$ref": "#/components/parameters/VersionNumber" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationPublicationRequest" }, "examples": { "synthetic": { "summary": "Synthetic publishCanonicalTransformerVersion request", "value": { "effective_from": "2026-08-01T10:00:00Z" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/ConfigurationMutationCreated" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Atomically publish and schedule an immutable transformer version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformerId, versionNumber, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Publică și programează atomic o versiune imuabilă a transformatorului", "x-docula-description-ro": "Publică și programează atomic o versiune imuabilă a transformatorului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformerId, versionNumber, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for publishCanonicalTransformerVersion.", "url": "/developers/api#idempotency" } } }, "/api/v1/transformers/{transformerId}/activations/{activationId}/cancel": { "post": { "operationId": "cancelCanonicalTransformerActivation", "summary": "Cancel a future unpinned transformer activation", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/TransformerID" }, { "$ref": "#/components/parameters/ActivationID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationCancellationRequest" }, "examples": { "synthetic": { "summary": "Synthetic cancelCanonicalTransformerActivation request", "value": { "reason_code": "synthetic_example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Cancel a future unpinned transformer activation. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformerId, activationId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Anulează o activare viitoare nefixată a transformatorului", "x-docula-description-ro": "Anulează o activare viitoare nefixată a transformatorului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformerId, activationId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for cancelCanonicalTransformerActivation.", "url": "/developers/api#idempotency" } } }, "/api/v1/transforms": { "get": { "operationId": "listTransforms", "summary": "List transform definitions visible to the current role", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/RegistryLimit" }, { "$ref": "#/components/parameters/RegistryCursor" } ], "responses": { "200": { "$ref": "#/components/responses/TransformListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "List transform definitions visible to the current role. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Listează transformările vizibile rolului curent", "x-docula-description-ro": "Listează transformările vizibile rolului curent. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 256 } ] }, "externalDocs": { "description": "Read the pagination convention for listTransforms.", "url": "/developers/api#pagination" } }, "post": { "operationId": "createTransform", "summary": "Create a mutable declarative transform draft", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 270336, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTransformRequest" }, "examples": { "synthetic": { "summary": "Synthetic createTransform request", "value": { "name": "synthetic-example", "description": "synthetic-example", "source": "synthetic-example", "format": "yaml" } } } } } }, "responses": { "201": { "$ref": "#/components/responses/TransformCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/TransformMutationDenied" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Create a mutable declarative transform draft. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, request body. HTTP success: 201; documented failures: 401, 403, 405, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Creează o ciornă editabilă de transformare declarativă", "x-docula-description-ro": "Creează o ciornă editabilă de transformare declarativă. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, request body. Succes HTTP: 201; erori documentate: 401, 403, 405, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 270336, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for createTransform.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transforms/{transformId}": { "get": { "operationId": "getTransform", "summary": "Read a transform and its visible immutable versions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformID" } ], "responses": { "200": { "$ref": "#/components/responses/TransformOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Read a transform and its visible immutable versions. Reads the identified resource without mutation. Required inputs: transformId. HTTP success: 200; documented failures: 401, 403, 404, 405, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește o transformare și versiunile sale imuabile vizibile", "x-docula-description-ro": "Citește o transformare și versiunile sale imuabile vizibile. Citește resursa identificată fără modificare. Intrări obligatorii: transformId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getTransform.", "url": "/developers/api#configuration-lifecycle" } }, "put": { "operationId": "updateTransformDraft", "summary": "Update a transform draft using optimistic concurrency", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 270336, "parameters": [ { "$ref": "#/components/parameters/TransformID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTransformRequest" }, "examples": { "synthetic": { "summary": "Synthetic updateTransformDraft request", "value": { "name": "synthetic-example", "description": "synthetic-example", "source": "synthetic-example", "format": "yaml", "expected_revision": 1 } } } } } }, "responses": { "200": { "$ref": "#/components/responses/TransformUpdated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/TransformMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Update a transform draft using optimistic concurrency. Applies the documented change under the declared preconditions. Required inputs: transformId, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Actualizează ciorna transformării cu verificarea reviziei", "x-docula-description-ro": "Actualizează ciorna transformării cu verificarea reviziei. Aplică modificarea documentată cu precondițiile declarate. Intrări obligatorii: transformId, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 270336, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for updateTransformDraft.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transforms/{transformId}/validate": { "post": { "operationId": "validateTransformDraft", "summary": "Validate declarative-v1 source without persisting a version", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 270336, "parameters": [ { "$ref": "#/components/parameters/TransformID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateTransformRequest" }, "examples": { "synthetic": { "summary": "Synthetic validateTransformDraft request", "value": { "source": "synthetic-example", "format": "yaml" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/TransformValidationOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/TransformMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Validate declarative-v1 source without persisting a version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformId, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Validează sursa declarative-v1 fără a salva o versiune", "x-docula-description-ro": "Validează sursa declarative-v1 fără a salva o versiune. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformId, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 270336, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for validateTransformDraft.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transforms/{transformId}/preview": { "post": { "operationId": "previewTransform", "summary": "Evaluate unsaved declarative-v1 source against an immutable case", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 270336, "parameters": [ { "$ref": "#/components/parameters/TransformID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreviewTransformRequest" }, "examples": { "synthetic": { "summary": "Synthetic previewTransform request", "value": { "source": "synthetic-example", "format": "yaml", "case_id": "11111111-1111-4111-8111-111111111111" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/TransformPreviewOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/TransformMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/TransformValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Evaluate unsaved declarative-v1 source against an immutable case. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformId, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Evaluează sursa declarative-v1 nesalvată pe un caz imuabil", "x-docula-description-ro": "Evaluează sursa declarative-v1 nesalvată pe un caz imuabil. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformId, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 270336, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for previewTransform.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transforms/{transformId}/versions": { "post": { "operationId": "createTransformVersion", "summary": "Create a sequential immutable transform version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevisionRequest" }, "examples": { "synthetic": { "summary": "Synthetic createTransformVersion request", "value": { "expected_revision": 1 } } } } } }, "responses": { "201": { "$ref": "#/components/responses/TransformVersionCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/TransformMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/TransformValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Create a sequential immutable transform version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformId, Origin, X-CSRF-Token, request body. HTTP success: 201; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Creează următoarea versiune imuabilă a transformării", "x-docula-description-ro": "Creează următoarea versiune imuabilă a transformării. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformId, Origin, X-CSRF-Token, request body. Succes HTTP: 201; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for createTransformVersion.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/transforms/{transformId}/versions/{versionNumber}/publish": { "post": { "operationId": "publishTransformVersion", "summary": "Publish an immutable transform version", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformID" }, { "$ref": "#/components/parameters/VersionNumber" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic publishTransformVersion request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/TransformVersionUpdated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/TransformMutationDenied" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Transformers" ], "description": "Publish an immutable transform version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: transformId, versionNumber, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Publică o versiune imuabilă a transformării", "x-docula-description-ro": "Publică o versiune imuabilă a transformării. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: transformId, versionNumber, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for publishTransformVersion.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/templates": { "get": { "operationId": "listTemplates", "summary": "List immutable DOCX templates", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/RegistryLimit" }, { "$ref": "#/components/parameters/RegistryCursor" } ], "responses": { "200": { "$ref": "#/components/responses/TemplateListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Templates" ], "description": "List immutable DOCX templates. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Listează șabloanele DOCX imuabile", "x-docula-description-ro": "Listează șabloanele DOCX imuabile. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 256 } ] }, "externalDocs": { "description": "Read the pagination convention for listTemplates.", "url": "/developers/api#pagination" } }, "post": { "operationId": "createTemplate", "summary": "Create a canonical template family with JSON or preserve the legacy immediate multipart upload", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 11534336, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/ConditionalIdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTemplateCreateRequest" }, "examples": { "synthetic": { "summary": "Synthetic createTemplate request", "value": { "slug": "synthetic-example", "name": "synthetic-example" } } } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/CreateTemplateRequest" }, "examples": { "synthetic": { "summary": "Synthetic createTemplate request", "value": { "name": "synthetic-example", "description": "synthetic-example", "file": "synthetic-file-content" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/TemplateFamilyOrLegacyCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/MutationRejected" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailedDetailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Create a canonical template family with JSON or preserve the legacy immediate multipart upload. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, request body. HTTP success: 200, 201; documented failures: 401, 403, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Creează o familie canonică de șabloane sau păstrează încărcarea multipart existentă", "x-docula-description-ro": "Creează o familie canonică de șabloane sau păstrează încărcarea multipart existentă. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 11534336, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for createTemplate.", "url": "/developers/api#idempotency" } } }, "/api/v1/templates/{templateId}": { "get": { "operationId": "getTemplate", "summary": "Read a template and immutable versions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TemplateID" } ], "responses": { "200": { "$ref": "#/components/responses/TemplateOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Read a template and immutable versions. Reads the identified resource without mutation. Required inputs: templateId. HTTP success: 200; documented failures: 401, 403, 404, 405, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește un șablon și versiunile sale imuabile", "x-docula-description-ro": "Citește un șablon și versiunile sale imuabile. Citește resursa identificată fără modificare. Intrări obligatorii: templateId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getTemplate.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/templates/{templateId}/draft": { "get": { "operationId": "getCanonicalTemplateDraft", "summary": "Read the verified revisioned template draft metadata", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TemplateID" } ], "responses": { "200": { "$ref": "#/components/responses/CanonicalTemplateDraftOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Read the verified revisioned template draft metadata. Reads the identified resource without mutation. Required inputs: templateId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește metadatele ciornei verificate a șablonului", "x-docula-description-ro": "Citește metadatele ciornei verificate a șablonului. Citește resursa identificată fără modificare. Intrări obligatorii: templateId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getCanonicalTemplateDraft.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/templates/{templateId}/draft-content": { "post": { "operationId": "updateCanonicalTemplateDraft", "summary": "Upload and verify the next mutable template draft under a strong revision precondition", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 11534336, "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/IfMatchTemplateRevision" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/CreateTemplateVersionRequest" }, "examples": { "synthetic": { "summary": "Synthetic updateCanonicalTemplateDraft request", "value": { "file": "synthetic-file-content" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "412": { "$ref": "#/components/responses/ConfigurationPreconditionFailed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "428": { "$ref": "#/components/responses/ConfigurationPreconditionRequired" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Upload and verify the next mutable template draft under a strong revision precondition. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: templateId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Send the current strong revision precondition and recover explicitly from stale writes.", "x-docula-summary-ro": "Încarcă și verifică următoarea ciornă a șablonului cu verificarea reviziei", "x-docula-description-ro": "Încarcă și verifică următoarea ciornă a șablonului cu verificarea reviziei. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: templateId, Origin, X-CSRF-Token, Idempotency-Key, If-Match, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Trimite precondiția puternică a reviziei curente și recuperează explicit după o scriere învechită.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "If-Match", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 11534336, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the concurrency convention for updateCanonicalTemplateDraft.", "url": "/developers/api#concurrency" } } }, "/api/v1/templates/{templateId}/versions": { "get": { "operationId": "listCanonicalTemplateVersions", "summary": "List bounded immutable template versions", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TemplateID" } ], "responses": { "200": { "$ref": "#/components/responses/CanonicalTemplateVersionsOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "List bounded immutable template versions. Reads the identified resource without mutation. Required inputs: templateId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează versiunile imuabile ale șablonului", "x-docula-description-ro": "Listează versiunile imuabile ale șablonului. Citește resursa identificată fără modificare. Intrări obligatorii: templateId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listCanonicalTemplateVersions.", "url": "/developers/api#configuration-lifecycle" } }, "post": { "operationId": "createTemplateVersion", "summary": "Freeze the canonical draft with JSON or preserve the legacy immediate multipart upload", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 11534336, "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/ConditionalIdempotencyKey" }, { "$ref": "#/components/parameters/ConditionalIfMatchRevision" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false }, "examples": { "synthetic": { "summary": "Synthetic createTemplateVersion request", "value": {} } } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/CreateTemplateVersionRequest" }, "examples": { "synthetic": { "summary": "Synthetic createTemplateVersion request", "value": { "file": "synthetic-file-content" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/TemplateVersionOrLegacyCreated" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/MutationRejected" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "412": { "$ref": "#/components/responses/ConfigurationPreconditionFailed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailedDetailed" }, "428": { "$ref": "#/components/responses/ConfigurationPreconditionRequired" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Freeze the canonical draft with JSON or preserve the legacy immediate multipart upload. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: templateId, Origin, X-CSRF-Token, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Send the current strong revision precondition and recover explicitly from stale writes.", "x-docula-summary-ro": "Fixează ciorna canonică sau păstrează încărcarea multipart existentă", "x-docula-description-ro": "Fixează ciorna canonică sau păstrează încărcarea multipart existentă. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: templateId, Origin, X-CSRF-Token, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 409, 412, 415, 422, 428, 500, 503. Trimite precondiția puternică a reviziei curente și recuperează explicit după o scriere învechită.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 11534336, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the concurrency convention for createTemplateVersion.", "url": "/developers/api#concurrency" } } }, "/api/v1/templates/{templateId}/versions:resolve": { "get": { "operationId": "resolveCanonicalTemplateVersion", "summary": "Resolve the template activation at official object time", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/AsOf" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationActivationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Resolve the template activation at official object time. Reads the identified resource without mutation. Required inputs: templateId, at. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Rezolvă activarea șablonului la momentul oficial al obiectului", "x-docula-description-ro": "Rezolvă activarea șablonului la momentul oficial al obiectului. Citește resursa identificată fără modificare. Intrări obligatorii: templateId, at. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for resolveCanonicalTemplateVersion.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/templates/{templateId}/activations": { "get": { "operationId": "listCanonicalTemplateActivations", "summary": "List bounded template activation history", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TemplateID" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationActivationsOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "List bounded template activation history. Reads the identified resource without mutation. Required inputs: templateId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează istoricul activărilor șablonului", "x-docula-description-ro": "Listează istoricul activărilor șablonului. Citește resursa identificată fără modificare. Intrări obligatorii: templateId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listCanonicalTemplateActivations.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/templates/{templateId}/validate": { "post": { "operationId": "validateCanonicalTemplateDraft", "summary": "Validate the verified template draft without canonical writes", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic validateCanonicalTemplateDraft request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/CanonicalTemplateValidationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Validate the verified template draft without canonical writes. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: templateId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Validează ciorna verificată a șablonului fără scrieri canonice", "x-docula-description-ro": "Validează ciorna verificată a șablonului fără scrieri canonice. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: templateId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for validateCanonicalTemplateDraft.", "url": "/developers/api#idempotency" } } }, "/api/v1/templates/{templateId}/test": { "post": { "operationId": "testCanonicalTemplateDraft", "summary": "Compose DOCX and PDF probes without retaining output or canonical writes", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 525312, "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTemplateTestRequest" }, "examples": { "synthetic": { "summary": "Synthetic testCanonicalTemplateDraft request", "value": { "data": "synthetic-example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/CanonicalTemplateTestOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Compose DOCX and PDF probes without retaining output or canonical writes. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: templateId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Compune probe DOCX și PDF fără a păstra rezultatele", "x-docula-description-ro": "Compune probe DOCX și PDF fără a păstra rezultatele. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: templateId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 525312, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for testCanonicalTemplateDraft.", "url": "/developers/api#idempotency" } } }, "/api/v1/templates/{templateId}/versions/{versionNumber}/publish": { "post": { "operationId": "publishCanonicalTemplateVersion", "summary": "Atomically publish and schedule an immutable template version", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/VersionNumber" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationPublicationRequest" }, "examples": { "synthetic": { "summary": "Synthetic publishCanonicalTemplateVersion request", "value": { "effective_from": "2026-08-01T10:00:00Z" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "201": { "$ref": "#/components/responses/ConfigurationMutationCreated" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Atomically publish and schedule an immutable template version. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: templateId, versionNumber, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Publică și programează atomic o versiune imuabilă a șablonului", "x-docula-description-ro": "Publică și programează atomic o versiune imuabilă a șablonului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: templateId, versionNumber, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for publishCanonicalTemplateVersion.", "url": "/developers/api#idempotency" } } }, "/api/v1/templates/{templateId}/activations/{activationId}/cancel": { "post": { "operationId": "cancelCanonicalTemplateActivation", "summary": "Cancel a future unpinned template activation", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1024, "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/ActivationID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationCancellationRequest" }, "examples": { "synthetic": { "summary": "Synthetic cancelCanonicalTemplateActivation request", "value": { "reason_code": "synthetic_example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationMutationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Cancel a future unpinned template activation. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: templateId, activationId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Anulează o activare viitoare nefixată a șablonului", "x-docula-description-ro": "Anulează o activare viitoare nefixată a șablonului. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: templateId, activationId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1024, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for cancelCanonicalTemplateActivation.", "url": "/developers/api#idempotency" } } }, "/api/v1/templates/{templateId}/versions/{versionNumber}/preview": { "post": { "operationId": "previewTemplateVersion", "summary": "Resolve template bindings against a deterministic transformed case", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TemplateID" }, { "$ref": "#/components/parameters/VersionNumber" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplatePreviewRequest" }, "examples": { "synthetic": { "summary": "Synthetic previewTemplateVersion request", "value": { "transform_version_id": "11111111-1111-4111-8111-111111111111", "case_id": "11111111-1111-4111-8111-111111111111" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/TemplatePreviewOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/MutationRejected" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailedDetailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Templates" ], "description": "Resolve template bindings against a deterministic transformed case. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: templateId, versionNumber, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Rezolvă legăturile șablonului folosind un caz transformat determinist", "x-docula-description-ro": "Rezolvă legăturile șablonului folosind un caz transformat determinist. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: templateId, versionNumber, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for previewTemplateVersion.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/releases/validate": { "post": { "operationId": "validateCanonicalRelease", "summary": "Validate an exact transformation or document release without canonical writes", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1064960, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalReleaseValidationRequest" }, "examples": { "synthetic": { "summary": "Synthetic validateCanonicalRelease request", "value": { "processing_kind": "transformation", "name": "synthetic-example", "description": "synthetic-example", "ingestion_model_version_id": "11111111-1111-4111-8111-111111111111", "contract_version_id": "11111111-1111-4111-8111-111111111111", "transform_version_id": "11111111-1111-4111-8111-111111111111", "case_id": "11111111-1111-4111-8111-111111111111" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/CanonicalReleaseValidationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Releases" ], "description": "Validate an exact transformation or document release without canonical writes. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Validează o versiune exactă de transformare sau document fără scrieri canonice", "x-docula-description-ro": "Validează o versiune exactă de transformare sau document fără scrieri canonice. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1064960, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for validateCanonicalRelease.", "url": "/developers/api#idempotency" } } }, "/api/v1/releases": { "get": { "operationId": "listReleases", "summary": "List immutable published releases", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/ReleaseListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Releases" ], "description": "List immutable published releases. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Listează versiunile publicate și imuabile", "x-docula-description-ro": "Listează versiunile publicate și imuabile. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for listReleases.", "url": "/developers/api#configuration-lifecycle" } }, "post": { "operationId": "publishRelease", "summary": "Publish a legacy document release or an idempotent canonical exact release", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1064960, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Required exactly once for canonical requests containing processing_kind and ingestion_model_version_id; ignored by the preserved legacy request.", "schema": { "type": "string", "minLength": 8, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$" }, "example": "docs-example-0001", "x-docula-description-ro": "Identitatea cererii, limitată la actor. O reluare identică returnează rezultatul inițial; un conținut canonic diferit produce conflict." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/PublishReleaseRequest" }, { "$ref": "#/components/schemas/CanonicalReleaseValidationRequest" } ] }, "examples": { "synthetic": { "summary": "Synthetic publishRelease request", "value": { "name": "synthetic-example", "description": "synthetic-example", "contract_version_id": "11111111-1111-4111-8111-111111111111", "transform_version_id": "11111111-1111-4111-8111-111111111111", "template_version_id": "11111111-1111-4111-8111-111111111111", "case_id": "11111111-1111-4111-8111-111111111111" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/CanonicalReleasePublicationOK" }, "201": { "$ref": "#/components/responses/ReleasePublicationCreated" }, "401": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "403": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "404": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "405": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "409": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "415": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "422": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "500": { "$ref": "#/components/responses/ReleasePublicationProblem" }, "503": { "$ref": "#/components/responses/ReleasePublicationProblem" } }, "tags": [ "Releases" ], "description": "Publish a legacy document release or an idempotent canonical exact release. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, request body. HTTP success: 200, 201; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Publică idempotent o versiune exactă sau o versiune de document existentă", "x-docula-description-ro": "Publică idempotent o versiune exactă sau o versiune de document existentă. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, request body. Succes HTTP: 200, 201; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1064960, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for publishRelease.", "url": "/developers/api#idempotency" } } }, "/api/v1/releases/{releaseId}": { "get": { "operationId": "getRelease", "summary": "Read an immutable release manifest", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ReleaseID" } ], "responses": { "200": { "$ref": "#/components/responses/ReleaseOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Releases" ], "description": "Read an immutable release manifest. Reads the identified resource without mutation. Required inputs: releaseId. HTTP success: 200; documented failures: 401, 403, 404, 405, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește manifestul unei versiuni imuabile", "x-docula-description-ro": "Citește manifestul unei versiuni imuabile. Citește resursa identificată fără modificare. Intrări obligatorii: releaseId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getRelease.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/releases/lookup": { "get": { "operationId": "findPublishedRelease", "summary": "Find one immutable published release by its exact component identity", "security": [ { "sessionCookie": [] } ], "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 160 }, "example": "synthetic-example", "description": "Exact published release name.", "x-docula-description-ro": "Numele exact al release-ului publicat." }, { "name": "description", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 2000 }, "example": "synthetic-example", "description": "Exact published release description.", "x-docula-description-ro": "Descrierea exactă a release-ului publicat." }, { "name": "contract_version_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Exact immutable contract-version UUID pinned by the release.", "x-docula-description-ro": "UUID-ul exact al versiunii imuabile de contract fixate de release." }, { "name": "transform_version_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Exact immutable transform-version UUID pinned by the release.", "x-docula-description-ro": "UUID-ul exact al versiunii imuabile de transformare fixate de release." }, { "name": "template_version_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Exact immutable template-version UUID pinned by the release.", "x-docula-description-ro": "UUID-ul exact al versiunii imuabile de șablon fixate de release." }, { "name": "case_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Exact immutable case UUID pinned by the release.", "x-docula-description-ro": "UUID-ul exact al cazului imuabil fixat de release." } ], "responses": { "200": { "$ref": "#/components/responses/ReleaseOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Releases" ], "description": "Find one immutable published release by its exact component identity. Reads a bounded canonical view without mutation. Required inputs: name, description, contract_version_id, transform_version_id, template_version_id, case_id. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Găsește o versiune publicată după identitatea exactă a componentelor", "x-docula-description-ro": "Găsește o versiune publicată după identitatea exactă a componentelor. Citește o vedere canonică limitată fără modificare. Intrări obligatorii: name, description, contract_version_id, transform_version_id, template_version_id, case_id. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "name", "maximum": null, "max_length": 160 }, { "name": "description", "maximum": null, "max_length": 2000 } ] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for findPublishedRelease.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/configuration-deployments/validate": { "post": { "operationId": "validateConfigurationDeployment", "summary": "Dry-run a canonical configuration deployment without writes", "description": "Only administrator and engineer sessions may validate. operator, auditor, and business_viewer are denied. Validation preserves item order, resolves at most 100 local references, and creates no canonical state.", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationDeploymentManifest" }, "examples": { "synthetic": { "summary": "Synthetic validateConfigurationDeployment request", "value": { "schema": "docula-configuration-deployment-v1", "items": [ { "local_ref": "synthetic-example", "kind": "ingestion_model", "operation": "deploy", "family": { "slug": "synthetic-example", "name": "synthetic-example" }, "definition": { "contract_version_id": "11111111-1111-4111-8111-111111111111", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "definition": "synthetic-example" }, "effective_from": "2026-08-01T10:00:00Z" } ] } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationDeploymentValidationOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Configuration deployments" ], "x-docula-summary-ro": "Simulează aplicarea unei configurații canonice fără scrieri", "x-docula-description-ro": "Numai administratorul și inginerul pot valida; celelalte roluri sunt refuzate. Validarea nu creează stare canonică.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for validateConfigurationDeployment.", "url": "/developers/api#idempotency" } } }, "/api/v1/configuration-deployments": { "get": { "operationId": "listConfigurationDeployments", "summary": "List bounded redacted configuration deployment summaries newest first", "description": "Administrator, engineer, operator, and auditor sessions with configuration_read may list summaries. business_viewer is denied. Full manifests and outcomes remain available only through the separately authorized deployment resource.", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ConfigurationDeploymentLimit" }, { "$ref": "#/components/parameters/ConfigurationDeploymentCursor" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationDeploymentListOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Configuration deployments" ], "x-docula-summary-ro": "Listează cronologic aplicările de configurație cu date sensibile mascate", "x-docula-description-ro": "Administratorul, inginerul, operatorul și auditorul pot lista rezumatele; business_viewer este refuzat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 512 } ] }, "externalDocs": { "description": "Read the pagination convention for listConfigurationDeployments.", "url": "/developers/api#pagination" } }, "post": { "operationId": "applyConfigurationDeployment", "summary": "Atomically apply a canonical configuration deployment", "description": "Only administrator and engineer sessions may apply. operator, auditor, and business_viewer are denied. The exact actor/key/request replays the stored immutable result; changed content under the same key conflicts.", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 2097152, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationDeploymentManifest" }, "examples": { "synthetic": { "summary": "Synthetic applyConfigurationDeployment request", "value": { "schema": "docula-configuration-deployment-v1", "items": [ { "local_ref": "synthetic-example", "kind": "ingestion_model", "operation": "deploy", "family": { "slug": "synthetic-example", "name": "synthetic-example" }, "definition": { "contract_version_id": "11111111-1111-4111-8111-111111111111", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "definition": "synthetic-example" }, "effective_from": "2026-08-01T10:00:00Z" } ] } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ConfigurationDeploymentReplay" }, "201": { "$ref": "#/components/responses/ConfigurationDeploymentApplied" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "409": { "$ref": "#/components/responses/ConfigurationConflict" }, "415": { "$ref": "#/components/responses/ConfigurationUnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Configuration deployments" ], "x-docula-summary-ro": "Aplică atomic o configurație canonică", "x-docula-description-ro": "Numai administratorul și inginerul pot aplica; celelalte roluri sunt refuzate. Reluarea identică returnează rezultatul imuabil.", "x-docula-roles": [ "administrator", "engineer" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 2097152, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for applyConfigurationDeployment.", "url": "/developers/api#idempotency" } } }, "/api/v1/configuration-deployments/{deploymentId}": { "get": { "operationId": "getConfigurationDeployment", "summary": "Read immutable configuration deployment evidence", "description": "Administrator, engineer, operator, and auditor sessions may read. business_viewer is denied. The response preserves the canonical manifest and at most 100 ordered committed outcomes.", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ConfigurationDeploymentID" } ], "responses": { "200": { "$ref": "#/components/responses/ConfigurationDeploymentOK" }, "401": { "$ref": "#/components/responses/ConfigurationAuthenticationRequired" }, "403": { "$ref": "#/components/responses/ConfigurationForbidden" }, "404": { "$ref": "#/components/responses/ConfigurationNotFound" }, "405": { "$ref": "#/components/responses/ConfigurationMethodNotAllowed" }, "422": { "$ref": "#/components/responses/ConfigurationValidationFailed" }, "500": { "$ref": "#/components/responses/ConfigurationInternalError" }, "503": { "$ref": "#/components/responses/ConfigurationDependencyUnavailable" } }, "tags": [ "Configuration deployments" ], "x-docula-summary-ro": "Citește dovada imuabilă a aplicării unei configurații", "x-docula-description-ro": "Administratorul, inginerul, operatorul și auditorul pot citi dovada; business_viewer este refuzat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getConfigurationDeployment.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/executions": { "get": { "operationId": "listExecutions", "summary": "List durable executions with bounded cursor pagination", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ExecutionLimit" }, { "$ref": "#/components/parameters/ExecutionCursor" } ], "responses": { "200": { "$ref": "#/components/responses/ExecutionListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Executions" ], "description": "List durable executions with bounded cursor pagination. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Listează execuțiile durabile cu paginare prin cursor", "x-docula-description-ro": "Listează execuțiile durabile cu paginare prin cursor. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "limit", "maximum": 100, "max_length": null } ] }, "externalDocs": { "description": "Read the pagination convention for listExecutions.", "url": "/developers/api#pagination" } }, "post": { "operationId": "submitExecution", "summary": "Submit an idempotent durable execution for an immutable release", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1048576, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmitExecutionRequest" }, "examples": { "synthetic": { "summary": "Synthetic submitExecution request", "value": { "release_id": "11111111-1111-4111-8111-111111111111", "input": "synthetic-example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/ExecutionReplay" }, "202": { "$ref": "#/components/responses/ExecutionAccepted" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/MutationRejected" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Executions" ], "description": "Submit an idempotent durable execution for an immutable release. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 202; documented failures: 401, 403, 404, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Trimite idempotent o execuție durabilă pentru o versiune imuabilă", "x-docula-description-ro": "Trimite idempotent o execuție durabilă pentru o versiune imuabilă. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 202; erori documentate: 401, 403, 404, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer", "operator" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1048576, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for submitExecution.", "url": "/developers/api#idempotency" } } }, "/api/v1/executions/{executionId}": { "get": { "operationId": "getExecution", "summary": "Read exact durable execution and ordered step state", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ExecutionID" } ], "responses": { "200": { "$ref": "#/components/responses/ExecutionOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Executions" ], "description": "Read exact durable execution and ordered step state. Reads the identified resource without mutation. Required inputs: executionId. HTTP success: 200; documented failures: 401, 403, 404, 405, 500, 503. Preserve the documented UTC interval and temporal-resolution semantics.", "x-docula-summary-ro": "Citește execuția durabilă exactă și starea ordonată a etapelor", "x-docula-description-ro": "Citește execuția durabilă exactă și starea ordonată a etapelor. Citește resursa identificată fără modificare. Intrări obligatorii: executionId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 500, 503. Păstrează intervalul UTC și semantica documentată de rezolvare temporală.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the time convention for getExecution.", "url": "/developers/api#time" } } }, "/api/v1/executions/{executionId}/events": { "get": { "operationId": "streamExecutionEvents", "summary": "Replay persisted execution events and continue as an authorized SSE stream", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/ExecutionID" }, { "$ref": "#/components/parameters/LastEventID" } ], "responses": { "200": { "$ref": "#/components/responses/ExecutionEventStream" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Executions" ], "description": "Replay persisted execution events and continue as an authorized SSE stream. Reads the identified resource without mutation. Required inputs: executionId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Resume from the last persisted event identity and deduplicate replayed SSE events.", "x-docula-summary-ro": "Reia evenimentele persistate și continuă fluxul SSE autorizat", "x-docula-description-ro": "Reia evenimentele persistate și continuă fluxul SSE autorizat. Citește resursa identificată fără modificare. Intrări obligatorii: executionId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Reia fluxul de la ultimul eveniment persistat și elimină duplicatele SSE reluate.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the events convention for streamExecutionEvents.", "url": "/developers/api#events" } } }, "/api/v1/executions/{executionId}/artifacts/{artifactId}/download": { "post": { "operationId": "downloadExecutionArtifact", "summary": "Authorize, verify, audit, and download one retained execution artifact", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 128, "parameters": [ { "$ref": "#/components/parameters/ExecutionID" }, { "$ref": "#/components/parameters/ArtifactID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic downloadExecutionArtifact request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/ArtifactDownload" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/MutationRejected" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Executions" ], "description": "Authorize, verify, audit, and download one retained execution artifact. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: executionId, artifactId, Origin, X-CSRF-Token, request body. HTTP success: 200; documented failures: 401, 403, 404, 405, 415, 422, 500, 503. Authorize the exact artifact identity and verify the returned bytes and hash.", "x-docula-summary-ro": "Autorizează, verifică, auditează și descarcă un artefact păstrat", "x-docula-description-ro": "Autorizează, verifică, auditează și descarcă un artefact păstrat. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: executionId, artifactId, Origin, X-CSRF-Token, request body. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 415, 422, 500, 503. Autorizează identitatea exactă a artefactului și verifică octeții și hashul returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "business_viewer" ], "x-docula-required-headers": [ "Content-Type", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 128, "parameters": [] }, "externalDocs": { "description": "Read the downloads convention for downloadExecutionArtifact.", "url": "/developers/api#downloads" } } }, "/api/v1/submissions": { "get": { "operationId": "listSubmissions", "summary": "List canonical submissions with separate ingestion, processing, and storage outcomes", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/SubmissionFrom" }, { "$ref": "#/components/parameters/SubmissionTo" }, { "$ref": "#/components/parameters/ObjectEffectiveFrom" }, { "$ref": "#/components/parameters/ObjectEffectiveTo" }, { "$ref": "#/components/parameters/SubmissionFilterID" }, { "$ref": "#/components/parameters/SubmissionReference" }, { "$ref": "#/components/parameters/IngestionOutcome" }, { "$ref": "#/components/parameters/ProcessingOutcome" }, { "$ref": "#/components/parameters/StorageAvailable" }, { "$ref": "#/components/parameters/SubmissionLimit" }, { "$ref": "#/components/parameters/SubmissionCursor" } ], "responses": { "200": { "$ref": "#/components/responses/SubmissionListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Submissions" ], "description": "List canonical submissions with separate ingestion, processing, and storage outcomes. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Listează solicitările canonice și rezultatele lor distincte", "x-docula-description-ro": "Listează solicitările canonice și rezultatele lor distincte. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "object_reference", "maximum": null, "max_length": 128 }, { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 512 } ] }, "externalDocs": { "description": "Read the pagination convention for listSubmissions.", "url": "/developers/api#pagination" } }, "post": { "operationId": "createSubmission", "summary": "Persist an idempotent source submission and run its internal ingestion decision", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 1048576, "parameters": [ { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmitSubmissionRequest" }, "examples": { "synthetic": { "summary": "Synthetic createSubmission request", "value": { "metadata": { "model_slug": "synthetic-example", "object_reference": "synthetic-example", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "payload": "synthetic-example" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/SubmissionReplay" }, "202": { "$ref": "#/components/responses/SubmissionAccepted" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/MutationRejected" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Submissions" ], "description": "Persist an idempotent source submission and run its internal ingestion decision. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 202; documented failures: 401, 403, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Salvează idempotent o solicitare și execută decizia internă de ingestie", "x-docula-description-ro": "Salvează idempotent o solicitare și execută decizia internă de ingestie. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 202; erori documentate: 401, 403, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer", "operator" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 1048576, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for createSubmission.", "url": "/developers/api#idempotency" } } }, "/api/v1/submissions/transformations": { "get": { "operationId": "listSubmissionTransformations", "summary": "List canonical transformation nodes across submissions in stable newest-first order", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/TransformationFrom" }, { "$ref": "#/components/parameters/TransformationTo" }, { "$ref": "#/components/parameters/TransformationObjectReference" }, { "$ref": "#/components/parameters/TransformationStatus" }, { "$ref": "#/components/parameters/TransformationLimit" }, { "$ref": "#/components/parameters/TransformationCursor" } ], "responses": { "200": { "$ref": "#/components/responses/TransformationListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Submissions" ], "description": "List canonical transformation nodes across submissions in stable newest-first order. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Listează cronologic transformările canonice ale solicitărilor", "x-docula-description-ro": "Listează cronologic transformările canonice ale solicitărilor. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "object_reference", "maximum": null, "max_length": 128 }, { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 512 } ] }, "externalDocs": { "description": "Read the pagination convention for listSubmissionTransformations.", "url": "/developers/api#pagination" } } }, "/api/v1/submissions/{submissionId}": { "get": { "operationId": "getSubmissionGraph", "summary": "Read one transactionally consistent Submission, Ingestion, Processing, and Storage graph", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/SubmissionID" } ], "responses": { "200": { "$ref": "#/components/responses/SubmissionGraphOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Submissions" ], "description": "Read one transactionally consistent Submission, Ingestion, Processing, and Storage graph. Reads the identified resource without mutation. Required inputs: submissionId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Preserve the documented UTC interval and temporal-resolution semantics.", "x-docula-summary-ro": "Citește graful coerent al solicitării, ingestiei, procesării și stocării", "x-docula-description-ro": "Citește graful coerent al solicitării, ingestiei, procesării și stocării. Citește resursa identificată fără modificare. Intrări obligatorii: submissionId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Păstrează intervalul UTC și semantica documentată de rezolvare temporală.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the time convention for getSubmissionGraph.", "url": "/developers/api#time" } } }, "/api/v1/submissions/{submissionId}/events": { "get": { "operationId": "streamSubmissionEvents", "summary": "Replay the persisted aggregate Submission history and continue as an authorized SSE stream", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/SubmissionID" }, { "$ref": "#/components/parameters/LastEventID" } ], "responses": { "200": { "$ref": "#/components/responses/SubmissionEventStream" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Submissions" ], "description": "Replay the persisted aggregate Submission history and continue as an authorized SSE stream. Reads the identified resource without mutation. Required inputs: submissionId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Resume from the last persisted event identity and deduplicate replayed SSE events.", "x-docula-summary-ro": "Reia istoricul solicitării și continuă fluxul SSE autorizat", "x-docula-description-ro": "Reia istoricul solicitării și continuă fluxul SSE autorizat. Citește resursa identificată fără modificare. Intrări obligatorii: submissionId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Reia fluxul de la ultimul eveniment persistat și elimină duplicatele SSE reluate.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the events convention for streamSubmissionEvents.", "url": "/developers/api#events" } } }, "/api/v1/submissions/{submissionId}/elements/{elementId}": { "get": { "operationId": "getSubmissionElement", "summary": "Read one element only when it belongs to the Submission", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/SubmissionID" }, { "$ref": "#/components/parameters/SubmissionElementID" } ], "responses": { "200": { "$ref": "#/components/responses/SubmissionElementOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Submissions" ], "description": "Read one element only when it belongs to the Submission. Reads the identified resource without mutation. Required inputs: submissionId, elementId. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Preserve the documented UTC interval and temporal-resolution semantics.", "x-docula-summary-ro": "Citește un element numai dacă aparține solicitării", "x-docula-description-ro": "Citește un element numai dacă aparține solicitării. Citește resursa identificată fără modificare. Intrări obligatorii: submissionId, elementId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Păstrează intervalul UTC și semantica documentată de rezolvare temporală.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the time convention for getSubmissionElement.", "url": "/developers/api#time" } } }, "/api/v1/submissions/{submissionId}/elements/{elementId}/content": { "get": { "operationId": "getSubmissionElementContent", "summary": "Read exact original or canonical intermediate JSON when content is available", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/SubmissionID" }, { "$ref": "#/components/parameters/SubmissionElementID" } ], "responses": { "200": { "$ref": "#/components/responses/SubmissionElementContentOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/ContentUnavailable" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Submissions" ], "description": "Read exact original or canonical intermediate JSON when content is available. Reads the identified resource without mutation. Required inputs: submissionId, elementId. HTTP success: 200; documented failures: 401, 403, 404, 405, 409, 422, 500, 503. Preserve the documented UTC interval and temporal-resolution semantics.", "x-docula-summary-ro": "Citește conținutul JSON original sau intermediar disponibil", "x-docula-description-ro": "Citește conținutul JSON original sau intermediar disponibil. Citește resursa identificată fără modificare. Intrări obligatorii: submissionId, elementId. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 409, 422, 500, 503. Păstrează intervalul UTC și semantica documentată de rezolvare temporală.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the time convention for getSubmissionElementContent.", "url": "/developers/api#time" } } }, "/api/v1/analytics/summary": { "get": { "operationId": "getAnalyticsSummary", "summary": "Read bounded workflow aggregates and document-generation capacity", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/AnalyticsFrom" }, { "$ref": "#/components/parameters/AnalyticsTo" } ], "responses": { "200": { "$ref": "#/components/responses/AnalyticsSummaryOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Analytics" ], "description": "Read bounded workflow aggregates and document-generation capacity. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Preserve the documented UTC interval and temporal-resolution semantics.", "x-docula-summary-ro": "Citește agregatele fluxului și capacitatea de generare a documentelor", "x-docula-description-ro": "Citește agregatele fluxului și capacitatea de generare a documentelor. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Păstrează intervalul UTC și semantica documentată de rezolvare temporală.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the time convention for getAnalyticsSummary.", "url": "/developers/api#time" } } }, "/api/v1/analytics/decision-summary": { "get": { "operationId": "getAnalyticsDecisionSummary", "summary": "Read one canonical current and previous business cohort decision contract", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/AnalyticsFrom" }, { "$ref": "#/components/parameters/AnalyticsTo" } ], "responses": { "200": { "$ref": "#/components/responses/AnalyticsDecisionSummaryOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Analytics" ], "description": "Read one canonical current and previous business cohort decision contract. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Preserve the documented UTC interval and temporal-resolution semantics.", "x-docula-summary-ro": "Citește decizia canonică pentru cohortele curentă și anterioară", "x-docula-description-ro": "Citește decizia canonică pentru cohortele curentă și anterioară. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Păstrează intervalul UTC și semantica documentată de rezolvare temporală.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the time convention for getAnalyticsDecisionSummary.", "url": "/developers/api#time" } } }, "/api/v1/analytics/processing-contributors": { "get": { "operationId": "getAnalyticsProcessingContributors", "summary": "Read bounded canonical contributors to one returned processing-load bucket", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/AnalyticsContributorFrom" }, { "$ref": "#/components/parameters/AnalyticsContributorTo" }, { "$ref": "#/components/parameters/AnalyticsProcessingPhase" }, { "$ref": "#/components/parameters/AnalyticsBucketStart" }, { "$ref": "#/components/parameters/AnalyticsBucketWidth" }, { "$ref": "#/components/parameters/AnalyticsContributorLimit" }, { "$ref": "#/components/parameters/AnalyticsContributorCursor" } ], "responses": { "200": { "$ref": "#/components/responses/AnalyticsProcessingContributorsOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Analytics" ], "description": "Read bounded canonical contributors to one returned processing-load bucket. Reads a bounded canonical view without mutation. Required inputs: from, to, phase, bucket_start, bucket_width_seconds. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Citește contributorii canonici ai unui interval de încărcare", "x-docula-description-ro": "Citește contributorii canonici ai unui interval de încărcare. Citește o vedere canonică limitată fără modificare. Intrări obligatorii: from, to, phase, bucket_start, bucket_width_seconds. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "bucket_width_seconds", "maximum": 86400, "max_length": null }, { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 512 } ] }, "externalDocs": { "description": "Read the pagination convention for getAnalyticsProcessingContributors.", "url": "/developers/api#pagination" } } }, "/api/v1/analytics/failure-contributors": { "get": { "operationId": "getAnalyticsFailureContributors", "summary": "Read bounded canonical contributors to one returned failure group", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/AnalyticsContributorFrom" }, { "$ref": "#/components/parameters/AnalyticsContributorTo" }, { "$ref": "#/components/parameters/AnalyticsFailureScope" }, { "$ref": "#/components/parameters/AnalyticsFailureCode" }, { "$ref": "#/components/parameters/AnalyticsContributorLimit" }, { "$ref": "#/components/parameters/AnalyticsContributorCursor" } ], "responses": { "200": { "$ref": "#/components/responses/AnalyticsFailureContributorsOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Analytics" ], "description": "Read bounded canonical contributors to one returned failure group. Reads a bounded canonical view without mutation. Required inputs: from, to, scope, code. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Citește contributorii canonici ai unui grup de erori", "x-docula-description-ro": "Citește contributorii canonici ai unui grup de erori. Citește o vedere canonică limitată fără modificare. Intrări obligatorii: from, to, scope, code. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "code", "maximum": null, "max_length": 128 }, { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 512 } ] }, "externalDocs": { "description": "Read the pagination convention for getAnalyticsFailureContributors.", "url": "/developers/api#pagination" } } }, "/api/v1/storage": { "get": { "operationId": "listStorage", "summary": "List successful canonical artifacts through a PostgreSQL projection", "description": "Requires submission_read. Results are ordered by (created_at DESC, artifact_id DESC), use a filter-bound opaque cursor, and never scan S3 or expose object keys. Artifact download independently requires artifact_download.", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/StorageFrom" }, { "$ref": "#/components/parameters/StorageTo" }, { "$ref": "#/components/parameters/StorageObjectReference" }, { "$ref": "#/components/parameters/StorageModelSlug" }, { "$ref": "#/components/parameters/StorageProducingNodeAddress" }, { "$ref": "#/components/parameters/StorageFormat" }, { "$ref": "#/components/parameters/StorageLimit" }, { "$ref": "#/components/parameters/StorageCursor" } ], "responses": { "200": { "$ref": "#/components/responses/StorageListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Storage" ], "x-docula-summary-ro": "Listează artefactele canonice reușite din proiecția PostgreSQL", "x-docula-description-ro": "Necesită submission_read, folosește un cursor opac legat de filtre și nu expune cheile obiectelor din S3.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "object_reference", "maximum": null, "max_length": 128 }, { "name": "model_slug", "maximum": null, "max_length": 64 }, { "name": "producing_node_address", "maximum": null, "max_length": 1024 }, { "name": "limit", "maximum": 100, "max_length": null }, { "name": "cursor", "maximum": null, "max_length": 512 } ] }, "externalDocs": { "description": "Read the pagination convention for listStorage.", "url": "/developers/api#pagination" } } }, "/api/v1/demo/rca/scenarios": { "get": { "operationId": "getRCADemoScenarios", "summary": "Read the exact bounded canonical RCA Submission scenarios", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/RCADemoCatalogOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "RCA demo" ], "description": "Read the exact bounded canonical RCA Submission scenarios. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește scenariile canonice limitate pentru demonstrația RCA", "x-docula-description-ro": "Citește scenariile canonice limitate pentru demonstrația RCA. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getRCADemoScenarios.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/intake-test-lab/scenarios": { "get": { "operationId": "getIntakeLabCatalog", "summary": "Read the bounded synthetic CLWS scenario catalog and shared-release readiness", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/DemoCatalogOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "RCA demo" ], "description": "Read the bounded synthetic CLWS scenario catalog and shared-release readiness. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește catalogul sintetic CLWS și starea versiunii comune", "x-docula-description-ro": "Citește catalogul sintetic CLWS și starea versiunii comune. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getIntakeLabCatalog.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/intake-test-lab/runs/{scenarioId}": { "post": { "operationId": "runIntakeLabScenario", "summary": "Submit one canonical synthetic scenario through the shared release", "security": [ { "sessionCookie": [] } ], "x-docula-body-limit": 128, "parameters": [ { "$ref": "#/components/parameters/ScenarioID" }, { "$ref": "#/components/parameters/OriginRequired" }, { "$ref": "#/components/parameters/CSRFToken" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyObject" }, "examples": { "synthetic": { "summary": "Synthetic runIntakeLabScenario request", "value": {} } } } } }, "responses": { "200": { "$ref": "#/components/responses/ExecutionReplay" }, "202": { "$ref": "#/components/responses/ExecutionAccepted" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/MutationRejected" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "409": { "$ref": "#/components/responses/Conflict" }, "415": { "$ref": "#/components/responses/UnsupportedMediaType" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "RCA demo" ], "description": "Submit one canonical synthetic scenario through the shared release. Validates the documented inputs and creates or triggers the canonical outcome. Required inputs: scenarioId, Origin, X-CSRF-Token, Idempotency-Key, request body. HTTP success: 200, 202; documented failures: 401, 403, 405, 409, 415, 422, 500, 503. Reuse the request key only for an exact replay; changed canonical content conflicts.", "x-docula-summary-ro": "Trimite un scenariu sintetic canonic prin versiunea comună", "x-docula-description-ro": "Trimite un scenariu sintetic canonic prin versiunea comună. Validează intrările documentate și creează sau declanșează rezultatul canonic. Intrări obligatorii: scenarioId, Origin, X-CSRF-Token, Idempotency-Key, request body. Succes HTTP: 200, 202; erori documentate: 401, 403, 405, 409, 415, 422, 500, 503. Refolosește cheia cererii numai pentru o reluare identică; un conținut canonic diferit produce conflict.", "x-docula-roles": [ "administrator", "engineer", "operator" ], "x-docula-required-headers": [ "Content-Type", "Idempotency-Key", "Origin", "X-CSRF-Token" ], "x-docula-limits": { "body_bytes": 128, "parameters": [ { "name": "Idempotency-Key", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the idempotency convention for runIntakeLabScenario.", "url": "/developers/api#idempotency" } } }, "/api/v1/intake-test-lab/history": { "get": { "operationId": "getIntakeLabHistory", "summary": "Read persisted executions in the fixed synthetic fixture cohort", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/DemoLimit" } ], "responses": { "200": { "$ref": "#/components/responses/DemoHistoryOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "RCA demo" ], "description": "Read persisted executions in the fixed synthetic fixture cohort. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește execuțiile persistate din cohorta fixă de test", "x-docula-description-ro": "Citește execuțiile persistate din cohorta fixă de test. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "limit", "maximum": 100, "max_length": null } ] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getIntakeLabHistory.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/intake-test-lab/statistics": { "get": { "operationId": "getIntakeLabStatistics", "summary": "Read measured-only terminal cohort aggregates with sample and window provenance", "security": [ { "sessionCookie": [] } ], "responses": { "200": { "$ref": "#/components/responses/DemoStatisticsOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "RCA demo" ], "description": "Read measured-only terminal cohort aggregates with sample and window provenance. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Follow the canonical configuration dependency order and retain every returned identity and hash.", "x-docula-summary-ro": "Citește agregatele terminale măsurate și proveniența ferestrei", "x-docula-description-ro": "Citește agregatele terminale măsurate și proveniența ferestrei. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Respectă ordinea canonică a dependențelor de configurare și păstrează fiecare identitate și hash returnat.", "x-docula-roles": [ "administrator", "engineer", "operator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [] }, "externalDocs": { "description": "Read the configuration-lifecycle convention for getIntakeLabStatistics.", "url": "/developers/api#configuration-lifecycle" } } }, "/api/v1/audit-events": { "get": { "operationId": "listAuditEvents", "summary": "List append-only audit evidence with stable cursor pagination", "security": [ { "sessionCookie": [] } ], "parameters": [ { "$ref": "#/components/parameters/AuditLimit" }, { "$ref": "#/components/parameters/AuditCursor" }, { "$ref": "#/components/parameters/AuditCorrelationID" } ], "responses": { "200": { "$ref": "#/components/responses/AuditListOK" }, "401": { "$ref": "#/components/responses/AuthenticationRequired" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "405": { "$ref": "#/components/responses/MethodNotAllowed" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/DependencyUnavailable" } }, "tags": [ "Audit" ], "description": "List append-only audit evidence with stable cursor pagination. Reads a bounded canonical view without mutation. No request body or required parameters apply. HTTP success: 200; documented failures: 401, 403, 404, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.", "x-docula-summary-ro": "Listează dovezile de audit cu paginare stabilă prin cursor", "x-docula-description-ro": "Listează dovezile de audit cu paginare stabilă prin cursor. Citește o vedere canonică limitată fără modificare. Nu declară body sau parametri obligatorii. Succes HTTP: 200; erori documentate: 401, 403, 404, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.", "x-docula-roles": [ "administrator", "auditor" ], "x-docula-required-headers": [], "x-docula-limits": { "body_bytes": null, "parameters": [ { "name": "limit", "maximum": 100, "max_length": null }, { "name": "correlation_id", "maximum": null, "max_length": 128 } ] }, "externalDocs": { "description": "Read the pagination convention for listAuditEvents.", "url": "/developers/api#pagination" } } } }, "components": { "securitySchemes": { "sessionCookie": { "type": "apiKey", "in": "cookie", "name": "__Host-docula_session", "description": "The staging host-only cookie name. It is Secure, HttpOnly, SameSite=Lax, Path=/, and has no Domain, so the session is bound to the single docula.ro origin. Loopback development uses docula_dev_session. Both values are opaque session tokens." } }, "parameters": { "Origin": { "name": "Origin", "in": "header", "required": false, "description": "Must be one configured exact browser origin and its host must equal the request Host. One matching Referer is accepted only when Origin is absent.", "schema": { "type": "string", "format": "uri" }, "example": "http://127.0.0.1:18081", "x-docula-description-ro": "Trebuie să fie una dintre originile exacte configurate pentru browser, iar hostul ei trebuie să coincidă cu Host-ul cererii. Un Referer corespunzător este acceptat numai când Origin lipsește." }, "Referer": { "name": "Referer", "in": "header", "required": false, "description": "An absolute URL whose origin is one configured exact browser origin and whose host equals the request Host; accepted for login only when Origin is absent.", "schema": { "type": "string", "format": "uri" }, "example": "http://127.0.0.1:18081/developers/api", "x-docula-description-ro": "URL absolut a cărui origine este una dintre originile exacte configurate pentru browser și al cărui host coincide cu Host-ul cererii; este acceptat la autentificare numai când Origin lipsește." }, "OriginRequired": { "name": "Origin", "in": "header", "required": true, "description": "Must be one configured exact browser origin and its host must equal the request Host; no Referer fallback is accepted.", "schema": { "type": "string", "format": "uri" }, "example": "http://127.0.0.1:18081", "x-docula-description-ro": "Trebuie să fie una dintre originile exacte configurate pentru browser, iar hostul ei trebuie să coincidă cu Host-ul cererii. Un Referer corespunzător este acceptat numai când Origin lipsește." }, "CSRFToken": { "name": "X-CSRF-Token", "in": "header", "required": true, "description": "Per-session HMAC token returned by login or session-read; it is accepted only with that host's session and exact matching Origin.", "schema": { "type": "string", "minLength": 1 }, "example": "synthetic-csrf-token", "x-docula-description-ro": "Token HMAC specific sesiunii, returnat la autentificare sau la citirea sesiunii; este acceptat numai împreună cu sesiunea acelui host și cu un Origin exact corespunzător." }, "ContractID": { "name": "contractId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable contract UUID.", "x-docula-description-ro": "UUID-ul contractului imuabil." }, "VersionNumber": { "name": "versionNumber", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 }, "example": 1, "description": "Sequential immutable version number within the identified family.", "x-docula-description-ro": "Numărul secvențial al versiunii imuabile din familia identificată." }, "CaseID": { "name": "caseId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable deterministic case UUID.", "x-docula-description-ro": "UUID-ul cazului determinist imuabil." }, "TransformID": { "name": "transformId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable declarative transform UUID.", "x-docula-description-ro": "UUID-ul transformării declarative imuabile." }, "IngestionModelID": { "name": "ingestionModelId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable canonical ingestion-model family UUID.", "x-docula-description-ro": "UUID-ul familiei imuabile a modelului canonic de ingestie." }, "TransformerID": { "name": "transformerId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable canonical transformer family UUID.", "x-docula-description-ro": "UUID-ul familiei imuabile a transformatorului canonic." }, "ActivationID": { "name": "activationId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable future-activation UUID owned by the identified configuration family.", "x-docula-description-ro": "UUID-ul activării viitoare imuabile, deținută de familia de configurare identificată." }, "AsOf": { "name": "at", "in": "query", "required": true, "description": "Official object timestamp resolved with UTC RFC3339Nano precision.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Momentul oficial al obiectului, rezolvat cu precizie UTC RFC3339Nano." }, "TemplateID": { "name": "templateId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable canonical template family UUID.", "x-docula-description-ro": "UUID-ul familiei imuabile a șablonului canonic." }, "ReleaseID": { "name": "releaseId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable published release UUID.", "x-docula-description-ro": "UUID-ul release-ului publicat imuabil." }, "ConfigurationDeploymentID": { "name": "deploymentId", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable configuration-deployment UUID.", "x-docula-description-ro": "UUID-ul deploymentului imuabil de configurare." }, "ConfigurationDeploymentLimit": { "name": "limit", "in": "query", "required": false, "description": "Maximum summaries returned in newest-first canonical order.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 }, "example": 25, "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "ConfigurationDeploymentCursor": { "name": "cursor", "in": "query", "required": false, "description": "Opaque (created_at, id) cursor from the preceding page.", "schema": { "type": "string", "minLength": 1, "maxLength": 512 }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare." }, "ExecutionID": { "name": "executionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable durable execution UUID.", "x-docula-description-ro": "UUID-ul execuției durabile imuabile." }, "ArtifactID": { "name": "artifactId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable execution-artifact UUID owned by the identified execution.", "x-docula-description-ro": "UUID-ul artefactului imuabil, deținut de execuția identificată." }, "ExecutionLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "ExecutionCursor": { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare.", "description": "Opaque stable cursor from the preceding ordered page; preserve the operation filters when continuing." }, "ScenarioID": { "name": "scenarioId", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "monthly", "semiannual", "annual", "invalid" ] }, "example": "monthly", "description": "Exact identifier from the fixed intake-test-lab scenario catalog.", "x-docula-description-ro": "Identificatorul exact din catalogul fix de scenarii al laboratorului de ingestie." }, "DemoLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 }, "example": 30, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "LastEventID": { "name": "Last-Event-ID", "in": "header", "required": false, "description": "Last persisted numeric event ID received by the client.", "schema": { "type": "integer", "format": "int64", "minimum": 0 }, "example": 0, "x-docula-description-ro": "Ultimul ID numeric al evenimentului persistat primit de client." }, "AuditLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "AuditCursor": { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare.", "description": "Opaque stable cursor from the preceding ordered page; preserve the operation filters when continuing." }, "AuditCorrelationID": { "name": "correlation_id", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Exact request correlation UUID recorded in audit evidence.", "x-docula-description-ro": "UUID-ul exact de corelare a cererii înregistrat în dovada de audit." }, "AnalyticsFrom": { "name": "from", "in": "query", "required": false, "description": "Inclusive UTC cohort boundary aligned to an exact hour. Omit with to for the latest completed-hour 30-day default.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC inclusivă pentru received_at; implicit este cu 30 de zile înainte de to." }, "AnalyticsTo": { "name": "to", "in": "query", "required": false, "description": "Exclusive UTC cohort boundary aligned to an exact hour. Omit with from for the latest completed-hour 30-day default; the maximum explicit window is 366 days.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC exclusivă pentru received_at; implicit este momentul curent și permite un interval de cel mult 366 de zile." }, "AnalyticsContributorFrom": { "name": "from", "in": "query", "required": true, "description": "Inclusive UTC cohort boundary copied from decision-summary.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC inclusivă pentru received_at; implicit este cu 30 de zile înainte de to." }, "AnalyticsContributorTo": { "name": "to", "in": "query", "required": true, "description": "Exclusive UTC cohort boundary copied from decision-summary.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC exclusivă pentru received_at; implicit este momentul curent și permite un interval de cel mult 366 de zile." }, "AnalyticsProcessingPhase": { "name": "phase", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "ingestion", "transformation", "docx_composition", "pdf_generation" ] }, "example": "ingestion", "description": "Exact canonical processing phase returned by decision-summary.", "x-docula-description-ro": "Faza canonică exactă de procesare returnată de decision-summary." }, "AnalyticsBucketStart": { "name": "bucket_start", "in": "query", "required": true, "description": "Exact UTC start returned by decision-summary.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Începutul UTC exact returnat de decision-summary." }, "AnalyticsBucketWidth": { "name": "bucket_width_seconds", "in": "query", "required": true, "description": "Exact actual whole-hour bucket width returned by decision-summary.", "schema": { "type": "integer", "minimum": 3600, "maximum": 86400, "multipleOf": 3600 }, "example": 3600, "x-docula-description-ro": "Lățimea exactă, în ore întregi, a bucketului real returnat de decision-summary." }, "AnalyticsFailureScope": { "name": "scope", "in": "query", "required": true, "schema": { "type": "string", "enum": [ "ingestion_rejection", "processing_failure", "blocked_dependency" ] }, "example": "ingestion_rejection", "description": "Exact canonical failure scope returned by decision-summary.", "x-docula-description-ro": "Domeniul canonic exact al erorii returnat de decision-summary." }, "AnalyticsFailureCode": { "name": "code", "in": "query", "required": true, "description": "Exact canonical code returned by decision-summary; ingestion rejection codes use underscore words while processing codes also permit dots and hyphens.", "schema": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^(?:[a-z0-9]+(?:_[a-z0-9]+)*|[a-z][a-z0-9_.-]{0,63})$" }, "example": "synthetic-example", "x-docula-description-ro": "Codul canonic exact returnat de decision-summary; codurile de respingere la ingestie folosesc cuvinte separate prin underscore, iar codurile de procesare permit și puncte și cratime." }, "AnalyticsContributorLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "example": 50, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "AnalyticsContributorCursor": { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor bound to every normalized contributor filter.", "schema": { "type": "string", "minLength": 1, "maxLength": 512 }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare." }, "SubmissionFrom": { "name": "from", "in": "query", "required": false, "description": "Inclusive received_at UTC boundary; defaults to 30 days before to.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC inclusivă pentru received_at; implicit este cu 30 de zile înainte de to." }, "SubmissionTo": { "name": "to", "in": "query", "required": false, "description": "Exclusive received_at UTC boundary; defaults to now and permits at most 366 days.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC exclusivă pentru received_at; implicit este momentul curent și permite un interval de cel mult 366 de zile." }, "ObjectEffectiveFrom": { "name": "object_effective_from", "in": "query", "required": false, "description": "Inclusive official object-time boundary.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita inclusivă a timpului oficial al obiectului." }, "ObjectEffectiveTo": { "name": "object_effective_to", "in": "query", "required": false, "description": "Exclusive official object-time boundary.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita exclusivă a timpului oficial al obiectului." }, "SubmissionFilterID": { "name": "submission_id", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Exact Submission UUID filter.", "x-docula-description-ro": "Filtrul exact după UUID-ul Submission-ului." }, "SubmissionReference": { "name": "object_reference", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "example": "DOCS-EXAMPLE-0001", "description": "Exact customer object-reference filter.", "x-docula-description-ro": "Filtrul exact după referința obiectului clientului." }, "IngestionOutcome": { "name": "ingestion_outcome", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "received", "accepted", "rejected", "no_processing" ] }, "example": "received", "description": "Exact canonical ingestion-outcome filter.", "x-docula-description-ro": "Filtrul exact după rezultatul canonic al ingestiei." }, "ProcessingOutcome": { "name": "processing_outcome", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/SubmissionListProcessingOutcome" }, "example": "not_triggered", "description": "Exact canonical processing-outcome filter.", "x-docula-description-ro": "Filtrul exact după rezultatul canonic al procesării." }, "StorageAvailable": { "name": "storage_available", "in": "query", "required": false, "schema": { "type": "boolean" }, "example": false, "description": "When set, filters by whether retained storage evidence is available.", "x-docula-description-ro": "Când este setat, filtrează după disponibilitatea dovezii păstrate în stocare." }, "SubmissionLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 }, "example": 25, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "SubmissionCursor": { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor from the preceding page; it binds the normalized receipt window and every server filter.", "schema": { "type": "string", "minLength": 1, "maxLength": 512 }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare." }, "TransformationFrom": { "name": "from", "in": "query", "required": false, "description": "Inclusive transformation node created_at UTC boundary; defaults to 30 days before to.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC inclusivă pentru received_at; implicit este cu 30 de zile înainte de to." }, "TransformationTo": { "name": "to", "in": "query", "required": false, "description": "Exclusive transformation node created_at UTC boundary; defaults to now and permits at most 366 days.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC exclusivă pentru received_at; implicit este momentul curent și permite un interval de cel mult 366 de zile." }, "TransformationObjectReference": { "name": "object_reference", "in": "query", "required": false, "description": "Exact Submission object reference.", "schema": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "example": "DOCS-EXAMPLE-0001", "x-docula-description-ro": "Filtrul exact după referința obiectului clientului." }, "TransformationStatus": { "name": "status", "in": "query", "required": false, "schema": { "$ref": "#/components/schemas/ProcessingNodeStatus" }, "example": "pending", "description": "Exact canonical transformation-status filter.", "x-docula-description-ro": "Filtrul exact după starea canonică a transformării." }, "TransformationLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 }, "example": 25, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "TransformationCursor": { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor binding the normalized UTC window and every transformation filter.", "schema": { "type": "string", "minLength": 1, "maxLength": 512 }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare." }, "StorageFrom": { "name": "from", "in": "query", "required": false, "description": "Inclusive artifact created_at UTC boundary; defaults to 30 days before to.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC inclusivă pentru received_at; implicit este cu 30 de zile înainte de to." }, "StorageTo": { "name": "to", "in": "query", "required": false, "description": "Exclusive artifact created_at UTC boundary; defaults to now and permits at most 366 days.", "schema": { "type": "string", "format": "date-time" }, "example": "2026-08-01T10:00:00Z", "x-docula-description-ro": "Limita UTC exclusivă pentru received_at; implicit este momentul curent și permite un interval de cel mult 366 de zile." }, "StorageObjectReference": { "name": "object_reference", "in": "query", "required": false, "description": "Exact Submission object reference.", "schema": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "example": "DOCS-EXAMPLE-0001", "x-docula-description-ro": "Filtrul exact după referința obiectului clientului." }, "StorageModelSlug": { "name": "model_slug", "in": "query", "required": false, "description": "Exact ingestion model slug.", "schema": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "example": "synthetic-example", "x-docula-description-ro": "Slugul exact al modelului de ingestie." }, "StorageProducingNodeAddress": { "name": "producing_node_address", "in": "query", "required": false, "description": "Exact recursive business node address.", "schema": { "type": "string", "minLength": 3, "maxLength": 1024, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$" }, "example": "document:render", "x-docula-description-ro": "Adresa recursivă exactă a nodului business." }, "StorageFormat": { "name": "format", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "docx", "pdf" ] }, "example": "docx", "description": "Exact retained artifact format.", "x-docula-description-ro": "Formatul exact al artefactului păstrat." }, "StorageLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 }, "example": 25, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "StorageCursor": { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor binding the normalized UTC window and every Storage filter.", "schema": { "type": "string", "minLength": 1, "maxLength": 512 }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare." }, "RegistryLimit": { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100 }, "example": 100, "description": "Maximum number of ordered results to return on this page.", "x-docula-description-ro": "Numărul maxim de rezultate ordonate returnate în această pagină." }, "RegistryCursor": { "name": "cursor", "in": "query", "required": false, "description": "Opaque stable cursor from the preceding registry page.", "schema": { "type": "string", "minLength": 1, "maxLength": 256 }, "example": "synthetic-cursor", "x-docula-description-ro": "Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare." }, "SubmissionID": { "name": "submissionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "description": "Immutable Submission UUID.", "x-docula-description-ro": "UUID-ul Submission-ului imuabil." }, "SubmissionElementID": { "name": "elementId", "in": "path", "required": true, "description": "An immutable Submission, Processing, or Storage element UUID owned by this Submission.", "schema": { "type": "string", "format": "uuid" }, "example": "11111111-1111-4111-8111-000000000001", "x-docula-description-ro": "UUID-ul unui element imuabil de tip Submission, Processing sau Storage, deținut de acest Submission." }, "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": true, "description": "Actor-scoped request identity. An exact replay returns the original result; different canonical content conflicts.", "schema": { "type": "string", "minLength": 8, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$" }, "example": "docs-example-0001", "x-docula-description-ro": "Identitatea cererii, limitată la actor. O reluare identică returnează rezultatul inițial; un conținut canonic diferit produce conflict." }, "IfMatchRevision": { "name": "If-Match", "in": "header", "required": true, "description": "Current strong decimal draft revision ETag.", "schema": { "type": "string", "pattern": "^\"[1-9][0-9]*\"$" }, "example": "\"1\"", "x-docula-description-ro": "ETagul puternic al reviziei zecimale curente a ciornei." }, "IfMatchTemplateRevision": { "name": "If-Match", "in": "header", "required": true, "description": "Current strong template draft revision ETag; a new family starts at revision zero.", "schema": { "type": "string", "pattern": "^\"(?:0|[1-9][0-9]*)\"$" }, "example": "\"1\"", "x-docula-description-ro": "ETagul puternic al reviziei zecimale curente a ciornei." }, "ConditionalIdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Required for the canonical application/json form; omitted by the preserved legacy multipart form.", "schema": { "type": "string", "minLength": 8, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$" }, "example": "docs-example-0001", "x-docula-description-ro": "Identitatea cererii, limitată la actor. O reluare identică returnează rezultatul inițial; un conținut canonic diferit produce conflict." }, "ConditionalIfMatchRevision": { "name": "If-Match", "in": "header", "required": false, "description": "Required for the canonical application/json freeze; omitted by the preserved legacy multipart upload.", "schema": { "type": "string", "pattern": "^\"[1-9][0-9]*\"$" }, "example": "\"1\"", "x-docula-description-ro": "ETagul puternic al reviziei zecimale curente a ciornei." } }, "schemas": { "CanonicalTimestamp": { "type": "string", "format": "date-time", "description": "UTC timestamp serialized with RFC3339Nano precision." }, "ConfigurationIssue": { "type": "object", "additionalProperties": false, "required": [ "code", "stage", "resource_kind", "message", "correlation_id" ], "properties": { "code": { "type": "string", "maxLength": 64, "pattern": "^[a-z][a-z0-9_.:-]{0,63}$" }, "stage": { "type": "string", "maxLength": 64, "pattern": "^[a-z][a-z0-9_.:-]{0,63}$" }, "resource_kind": { "type": "string", "maxLength": 64, "pattern": "^[a-z][a-z0-9_.:-]{0,63}$" }, "resource_id": { "type": "string", "maxLength": 128 }, "path": { "type": "string", "maxLength": 512 }, "message": { "type": "string", "minLength": 1, "maxLength": 512 }, "dependency": { "type": "string", "maxLength": 64, "pattern": "^[a-z][a-z0-9_.:-]{0,63}$" }, "context": { "type": "object", "maxProperties": 16, "additionalProperties": { "type": "string", "maxLength": 256 } }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 } } }, "ConfigurationProblem": { "type": "object", "additionalProperties": false, "required": [ "type", "title", "status", "code", "detail", "correlation_id", "errors" ], "properties": { "type": { "type": "string", "pattern": "^/problems/[a-z_]+$" }, "title": { "type": "string", "minLength": 1 }, "status": { "type": "integer", "minimum": 400, "maximum": 599 }, "code": { "type": "string", "enum": [ "internal_error", "dependency_unavailable", "authentication_required", "csrf_rejected", "forbidden", "conflict", "not_found", "method_not_allowed", "unsupported_media_type", "validation_failed", "precondition_required", "precondition_failed" ] }, "detail": { "type": "string", "minLength": 1 }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "errors": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationIssue" } } } }, "CanonicalDefinitionSummary": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "description", "draft_revision", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 0 }, "latest_version_number": { "type": "integer", "minimum": 1 }, "latest_status": { "type": "string", "enum": [ "versioned", "published" ] }, "updated_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "CanonicalDefinitionVersion": { "type": "object", "additionalProperties": false, "required": [ "id", "number", "content_hash", "source_revision", "status", "created_by", "correlation_id", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "family_id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "number": { "type": "integer", "minimum": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "source_format": { "$ref": "#/components/schemas/TransformSourceFormat" }, "language": { "type": "string", "const": "declarative-v1" }, "source_revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "versioned", "published" ] }, "created_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1 }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "published_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "definition": { "$ref": "#/components/schemas/IngestionModelDefinition" } } }, "IngestionModelDefinitionNode": { "type": "object", "additionalProperties": false, "required": ["kind", "name", "slug", "transformer_slug"], "properties": { "kind": { "type": "string", "enum": ["transformation", "document_generation"] }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "parent_address": { "type": "string" }, "transformer_slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "template_slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } } }, "IngestionModelDefinition": { "type": "object", "additionalProperties": false, "required": ["schema", "nodes"], "properties": { "schema": { "type": "string", "const": "docula-ingestion-model-v1" }, "nodes": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/IngestionModelDefinitionNode" } } } }, "IngestionModelFamily": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "description", "draft_revision", "created_by", "created_at", "updated_at", "versions" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 1 }, "draft_contract_version_id": { "type": "string", "format": "uuid" }, "draft_contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_by": { "type": "string", "format": "uuid" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "updated_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "versions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/CanonicalDefinitionVersion" } } } }, "IngestionModelDraft": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "description", "definition", "revision", "contract_version_id", "contract_hash", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "definition": { "type": "object" }, "revision": { "type": "integer", "minimum": 1 }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "updated_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "IngestionModelCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "slug", "name", "definition", "contract_version_id", "contract_hash" ], "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 64 }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "definition": { "type": "object" }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "IngestionModelDraftUpdateRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "definition", "contract_version_id", "contract_hash" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "definition": { "type": "object" }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "IngestionModelValidationRequest": { "type": "object", "additionalProperties": false, "required": [ "definition", "contract_version_id", "contract_hash", "sample" ], "properties": { "definition": { "type": "object" }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "sample": { "type": "object", "additionalProperties": false, "required": [ "metadata", "payload" ], "properties": { "metadata": { "$ref": "#/components/schemas/SubmissionMetadata" }, "payload": true } } } }, "IngestionModelTestRequest": { "type": "object", "additionalProperties": false, "required": [ "sample" ], "properties": { "sample": { "type": "object", "additionalProperties": false, "required": [ "metadata", "payload" ], "properties": { "metadata": { "$ref": "#/components/schemas/SubmissionMetadata" }, "payload": true } } } }, "ConfigurationValidationResult": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors", "correlation_id" ], "properties": { "valid": { "type": "boolean" }, "errors": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationIssue" } }, "correlation_id": { "type": "string", "minLength": 1 } } }, "CanonicalTransformerDetail": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "description", "draft_revision", "created_by", "created_at", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 1 }, "created_by": { "type": "string", "format": "uuid" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "updated_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "CanonicalTransformerDraft": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "description", "source", "format", "revision", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "source": { "type": "string", "maxLength": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" }, "revision": { "type": "integer", "minimum": 1 }, "updated_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "CanonicalTransformerCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "slug", "name", "source", "format" ], "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 64 }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" } } }, "CanonicalTransformerDraftUpdateRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "source", "format" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" } } }, "CanonicalTransformerValidationRequest": { "type": "object", "additionalProperties": false, "required": [ "source", "format" ], "properties": { "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" } } }, "CanonicalTransformerTestRequest": { "type": "object", "additionalProperties": false, "required": [ "source", "format" ], "properties": { "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" }, "input": true, "case_id": { "type": "string", "format": "uuid" } }, "oneOf": [ { "required": [ "input" ], "not": { "required": [ "case_id" ] } }, { "required": [ "case_id" ], "not": { "required": [ "input" ] } } ] }, "CanonicalTransformerTestResult": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors", "trace", "correlation_id" ], "properties": { "valid": { "type": "boolean" }, "errors": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationIssue" } }, "definition_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "case_id": { "type": "string", "format": "uuid" }, "case_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "output": true, "output_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "trace": { "type": "object", "additionalProperties": false, "required": [ "entries", "truncated" ], "properties": { "entries": { "type": "array", "maxItems": 100, "items": { "type": "object", "additionalProperties": false, "required": [ "path", "operator", "status" ], "properties": { "path": { "type": "string", "maxLength": 512 }, "operator": { "type": "string", "maxLength": 64 }, "source_pointer": { "type": "string", "maxLength": 512 }, "result_type": { "type": "string", "maxLength": 64 }, "status": { "type": "string", "enum": [ "succeeded", "failed" ] } } } }, "truncated": { "type": "boolean" } } }, "correlation_id": { "type": "string", "minLength": 1 } } }, "ConfigurationActivation": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "family_id", "family_slug", "version_id", "version", "content_hash", "effective_from", "scheduled_by", "correlation_id", "scheduled_at", "status" ], "properties": { "id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template" ] }, "family_id": { "type": "string", "format": "uuid" }, "family_slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "scheduled_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1 }, "scheduled_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "cancelled_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "cancellation_code": { "type": "string", "pattern": "^[a-z0-9]+(?:_[a-z0-9]+)*$" }, "status": { "type": "string", "enum": [ "scheduled", "active", "superseded", "cancelled" ] } } }, "CanonicalTemplateDraft": { "type": "object", "additionalProperties": false, "required": [ "template_id", "slug", "revision", "original_filename", "media_type", "byte_size", "content_hash", "bindings", "updated_by", "verified_at" ], "properties": { "template_id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "revision": { "type": "integer", "minimum": 1 }, "original_filename": { "type": "string", "minLength": 1, "maxLength": 255 }, "media_type": { "type": "string", "const": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings": { "type": "array", "maxItems": 256, "items": { "type": "string", "maxLength": 256 } }, "updated_by": { "type": "string", "format": "uuid" }, "verified_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "CanonicalTemplateCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "slug", "name" ], "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 64 }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 } } }, "CanonicalTemplateVersion": { "type": "object", "additionalProperties": false, "required": [ "id", "template_id", "number", "original_filename", "media_type", "byte_size", "content_hash", "bindings", "created_by", "correlation_id", "created_at", "status" ], "properties": { "id": { "type": "string", "format": "uuid" }, "template_id": { "type": "string", "format": "uuid" }, "number": { "type": "integer", "minimum": 1 }, "original_filename": { "type": "string", "maxLength": 255 }, "media_type": { "type": "string", "const": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings": { "type": "array", "maxItems": 256, "items": { "type": "string", "maxLength": 256 } }, "created_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1 }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "source_revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "versioned", "published" ] }, "published_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "CanonicalTemplateTestRequest": { "type": "object", "additionalProperties": false, "required": [ "data" ], "properties": { "data": true } }, "CanonicalTemplateValidationResult": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors", "correlation_id" ], "properties": { "valid": { "type": "boolean" }, "result": { "type": "object", "additionalProperties": false, "required": [ "template_id", "draft_revision", "content_hash", "byte_size", "media_type", "bindings" ], "properties": { "template_id": { "type": "string", "format": "uuid" }, "draft_revision": { "type": "integer", "minimum": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "media_type": { "type": "string", "const": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }, "bindings": { "type": "array", "maxItems": 256, "items": { "type": "string" } } } }, "errors": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationIssue" } }, "correlation_id": { "type": "string", "minLength": 1 } } }, "CanonicalTemplateTestResult": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors", "correlation_id" ], "properties": { "valid": { "type": "boolean" }, "result": { "type": "object", "additionalProperties": false, "required": [ "template_id", "draft_revision", "template_hash", "input_hash", "bindings_hash", "docx", "pdf" ], "properties": { "template_id": { "type": "string", "format": "uuid" }, "draft_revision": { "type": "integer", "minimum": 1 }, "template_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "docx": { "$ref": "#/components/schemas/CanonicalArtifactProof" }, "pdf": { "$ref": "#/components/schemas/CanonicalArtifactProof" } } }, "errors": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationIssue" } }, "correlation_id": { "type": "string", "minLength": 1 } } }, "CanonicalArtifactProof": { "type": "object", "additionalProperties": false, "required": [ "media_type", "byte_size", "content_hash" ], "properties": { "media_type": { "type": "string", "enum": [ "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/pdf" ] }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 26214400 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "ConfigurationPublicationRequest": { "type": "object", "additionalProperties": false, "required": [ "effective_from" ], "properties": { "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationCancellationRequest": { "type": "object", "additionalProperties": false, "required": [ "reason_code" ], "properties": { "reason_code": { "type": "string", "pattern": "^[a-z0-9]+(?:_[a-z0-9]+)*$" } } }, "ConfigurationDefinitionFamilyOutcome": { "type": "object", "additionalProperties": false, "required": [ "kind", "id", "slug", "name", "description", "draft_revision", "created_at", "updated_at" ], "properties": { "kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template" ] }, "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 0 }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "updated_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationDefinitionVersionOutcome": { "type": "object", "additionalProperties": false, "required": [ "kind", "id", "family_id", "number", "content_hash", "source_revision", "status", "created_at", "reused" ], "properties": { "kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template" ] }, "id": { "type": "string", "format": "uuid" }, "family_id": { "type": "string", "format": "uuid" }, "number": { "type": "integer", "minimum": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "source_revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "versioned", "published" ] }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "reused": { "type": "boolean" } } }, "ConfigurationMutationResult": { "type": "object", "additionalProperties": false, "required": [ "resource_kind", "resource_id", "result", "response_hash", "idempotent_replay", "correlation_id" ], "properties": { "resource_kind": { "type": "string", "enum": [ "activation", "ingestion_model", "transformer", "template" ] }, "resource_id": { "type": "string", "format": "uuid" }, "result": { "oneOf": [ { "$ref": "#/components/schemas/ConfigurationPublicationOutcome" }, { "$ref": "#/components/schemas/ConfigurationCancellationOutcome" }, { "$ref": "#/components/schemas/ConfigurationDefinitionFamilyOutcome" }, { "$ref": "#/components/schemas/ConfigurationDefinitionVersionOutcome" } ] }, "response_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "idempotent_replay": { "type": "boolean" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "ConfigurationPublicationOutcome": { "type": "object", "additionalProperties": false, "required": [ "kind", "family_id", "family_slug", "version_id", "version", "content_hash", "activation_id", "effective_from", "scheduled_at" ], "properties": { "kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template" ] }, "family_id": { "type": "string", "format": "uuid" }, "family_slug": { "type": "string" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "activation_id": { "type": "string", "format": "uuid" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "scheduled_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationCancellationOutcome": { "type": "object", "additionalProperties": false, "required": [ "activation_id", "kind", "family_id", "version_id", "effective_from", "cancelled_at", "cancellation_code" ], "properties": { "activation_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template" ] }, "family_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "cancelled_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "cancellation_code": { "type": "string", "pattern": "^[a-z0-9]+(?:_[a-z0-9]+)*$" } } }, "CanonicalReleaseValidationRequest": { "type": "object", "additionalProperties": false, "required": [ "processing_kind", "name", "description", "ingestion_model_version_id", "contract_version_id", "transform_version_id" ], "properties": { "processing_kind": { "type": "string", "enum": [ "transformation", "document_generation" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "ingestion_model_version_id": { "type": "string", "format": "uuid" }, "node_address": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$", "maxLength": 1024 }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$", "maxLength": 1024 }, "producer_release_id": { "type": "string", "format": "uuid" }, "producer_release_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "validation_input": { "x-docula-max-bytes": 1048576 }, "validation_input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "contract_version_id": { "type": "string", "format": "uuid" }, "transform_version_id": { "type": "string", "format": "uuid" }, "template_version_id": { "type": "string", "format": "uuid" }, "case_id": { "type": "string", "format": "uuid" } }, "allOf": [ { "if": { "properties": { "processing_kind": { "const": "document_generation" } }, "required": [ "processing_kind" ] }, "then": { "required": [ "template_version_id" ] } }, { "if": { "properties": { "processing_kind": { "const": "transformation" } }, "required": [ "processing_kind" ] }, "then": { "not": { "required": [ "template_version_id" ] } } }, { "oneOf": [ { "required": [ "case_id" ], "not": { "anyOf": [ { "required": [ "node_address" ] }, { "required": [ "input_mode" ] }, { "required": [ "producer_node_address" ] }, { "required": [ "producer_release_id" ] }, { "required": [ "producer_release_hash" ] }, { "required": [ "validation_input" ] }, { "required": [ "validation_input_hash" ] } ] } }, { "required": [ "node_address", "input_mode", "case_id" ], "properties": { "processing_kind": { "const": "transformation" }, "input_mode": { "const": "submission" } }, "not": { "anyOf": [ { "required": [ "producer_node_address" ] }, { "required": [ "producer_release_id" ] }, { "required": [ "producer_release_hash" ] }, { "required": [ "validation_input" ] } ] } }, { "required": [ "node_address", "input_mode", "producer_node_address", "producer_release_id", "producer_release_hash", "validation_input" ], "properties": { "input_mode": { "const": "parent_output" } }, "not": { "required": [ "case_id" ] } } ] } ] }, "CanonicalReleaseEvidence": { "type": "object", "additionalProperties": false, "required": [ "processing_kind", "name", "description", "ingestion_model_version_id", "ingestion_model_hash", "contract_version_id", "contract_hash", "transform_version_id", "transform_hash", "output_hash", "manifest", "content_hash" ], "properties": { "processing_kind": { "type": "string", "enum": [ "transformation", "document_generation" ] }, "name": { "type": "string" }, "description": { "type": "string" }, "ingestion_model_version_id": { "type": "string", "format": "uuid" }, "ingestion_model_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "node_address": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$", "maxLength": 1024 }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$", "maxLength": 1024 }, "producer_release_id": { "type": "string", "format": "uuid" }, "producer_release_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "validation_input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "transform_version_id": { "type": "string", "format": "uuid" }, "transform_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "template_version_id": { "type": "string", "format": "uuid" }, "template_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "validation_case_id": { "type": "string", "format": "uuid" }, "case_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "output_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "manifest": { "type": "object" }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "allOf": [ { "oneOf": [ { "required": [ "validation_case_id", "case_hash" ], "not": { "required": [ "node_address" ] } }, { "required": [ "node_address", "input_mode", "validation_input_hash", "validation_case_id", "case_hash" ], "properties": { "input_mode": { "const": "submission" } }, "not": { "anyOf": [ { "required": [ "producer_node_address" ] }, { "required": [ "producer_release_id" ] }, { "required": [ "producer_release_hash" ] } ] } }, { "required": [ "node_address", "input_mode", "producer_node_address", "producer_release_id", "producer_release_hash", "validation_input_hash" ], "properties": { "input_mode": { "const": "parent_output" } }, "not": { "anyOf": [ { "required": [ "validation_case_id" ] }, { "required": [ "case_hash" ] } ] } } ] } ] }, "CanonicalReleaseValidationResult": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors", "correlation_id" ], "properties": { "valid": { "type": "boolean" }, "release": { "$ref": "#/components/schemas/CanonicalReleaseEvidence" }, "errors": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationIssue" } }, "correlation_id": { "type": "string", "minLength": 1 } } }, "CanonicalReleasePublicationOutcome": { "type": "object", "additionalProperties": false, "required": [ "release", "manifest" ], "properties": { "release": { "$ref": "#/components/schemas/Release" }, "manifest": { "type": "object" } } }, "CanonicalReleaseMutationResult": { "type": "object", "additionalProperties": false, "required": [ "resource_kind", "resource_id", "result", "response_hash", "idempotent_replay", "correlation_id" ], "properties": { "resource_kind": { "type": "string", "const": "release" }, "resource_id": { "type": "string", "format": "uuid" }, "result": { "$ref": "#/components/schemas/CanonicalReleasePublicationOutcome" }, "response_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "idempotent_replay": { "type": "boolean" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "ConfigurationDeploymentUUID": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "ConfigurationDeploymentInputHash": { "type": "string", "pattern": "^[0-9A-Fa-f]{64}$" }, "ConfigurationDeploymentHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "ConfigurationDeploymentLocalRef": { "type": "string", "pattern": "^[a-z][a-z0-9._-]{0,63}$" }, "ConfigurationDeploymentSlug": { "type": "string", "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "ConfigurationDeploymentNodeAddress": { "type": "string", "maxLength": 1024, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$" }, "ConfigurationDeploymentFamily": { "type": "object", "additionalProperties": false, "required": [ "slug", "name" ], "properties": { "slug": { "$ref": "#/components/schemas/ConfigurationDeploymentSlug" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 } } }, "ConfigurationDeploymentIngestionModelDefinition": { "type": "object", "additionalProperties": false, "required": [ "contract_version_id", "contract_hash", "definition" ], "properties": { "contract_version_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "contract_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "definition": {} } }, "ConfigurationDeploymentTransformerDefinition": { "type": "object", "additionalProperties": false, "required": [ "format", "source" ], "properties": { "format": { "type": "string", "enum": [ "json", "yaml" ] }, "source": { "type": "string", "minLength": 1, "maxLength": 262144 } } }, "ConfigurationDeploymentTemplateDefinition": { "type": "object", "additionalProperties": false, "required": [ "draft_content_hash" ], "properties": { "draft_content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } }, "ConfigurationDeploymentResourceRef": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "local_ref" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" } } }, { "type": "object", "additionalProperties": false, "required": [ "id" ], "properties": { "id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" } } }, { "type": "object", "additionalProperties": false, "required": [ "slug", "version", "content_hash" ], "properties": { "slug": { "$ref": "#/components/schemas/ConfigurationDeploymentSlug" }, "version": { "type": "integer", "minimum": 1 }, "content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } } ] }, "ConfigurationDeploymentProducerReleaseRef": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "local_ref" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" } } }, { "type": "object", "additionalProperties": false, "required": [ "id", "content_hash" ], "properties": { "id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } } ] }, "ConfigurationDeploymentTransformationEvidence": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "case_id", "case_hash", "output_hash" ], "properties": { "case_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "case_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } }, { "type": "object", "additionalProperties": false, "required": [ "validation_input", "validation_input_hash", "output_hash" ], "properties": { "validation_input": { "not": { "type": "null" } }, "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } } ] }, "ConfigurationDeploymentDocumentEvidence": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "case_id", "case_hash", "output_hash", "bindings_hash" ], "properties": { "case_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "case_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "bindings_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } }, { "type": "object", "additionalProperties": false, "required": [ "validation_input", "validation_input_hash", "output_hash", "bindings_hash" ], "properties": { "validation_input": { "not": { "type": "null" } }, "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "bindings_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } } ] }, "ConfigurationDeploymentReceiptTransformationEvidence": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "case_id", "case_hash", "output_hash" ], "properties": { "case_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "case_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } }, { "type": "object", "additionalProperties": false, "required": [ "validation_input_hash", "output_hash" ], "properties": { "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } } ] }, "ConfigurationDeploymentReceiptDocumentEvidence": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "case_id", "case_hash", "output_hash", "bindings_hash" ], "properties": { "case_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "case_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "bindings_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } }, { "type": "object", "additionalProperties": false, "required": [ "validation_input_hash", "output_hash", "bindings_hash" ], "properties": { "validation_input_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "output_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" }, "bindings_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentInputHash" } } } ] }, "ConfigurationDeploymentIngestionModelItem": { "type": "object", "additionalProperties": false, "required": [ "local_ref", "kind", "operation", "family", "definition", "effective_from" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "kind": { "const": "ingestion_model" }, "operation": { "const": "deploy" }, "family": { "$ref": "#/components/schemas/ConfigurationDeploymentFamily" }, "expected_revision": { "type": "integer", "minimum": 1 }, "definition": { "$ref": "#/components/schemas/ConfigurationDeploymentIngestionModelDefinition" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationDeploymentTransformerItem": { "type": "object", "additionalProperties": false, "required": [ "local_ref", "kind", "operation", "family", "definition", "effective_from" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "kind": { "const": "transformer" }, "operation": { "const": "deploy" }, "family": { "$ref": "#/components/schemas/ConfigurationDeploymentFamily" }, "expected_revision": { "type": "integer", "minimum": 1 }, "definition": { "$ref": "#/components/schemas/ConfigurationDeploymentTransformerDefinition" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationDeploymentTemplateItem": { "type": "object", "additionalProperties": false, "required": [ "local_ref", "kind", "operation", "family", "definition", "effective_from" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "kind": { "const": "template" }, "operation": { "const": "deploy" }, "family": { "$ref": "#/components/schemas/ConfigurationDeploymentFamily" }, "expected_revision": { "type": "integer", "minimum": 0 }, "definition": { "$ref": "#/components/schemas/ConfigurationDeploymentTemplateDefinition" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationDeploymentTransformationReleaseItem": { "type": "object", "additionalProperties": false, "required": [ "local_ref", "kind", "operation", "processing_kind", "name", "ingestion_model", "transformer", "validation_evidence" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "kind": { "const": "release" }, "operation": { "const": "publish" }, "processing_kind": { "const": "transformation" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "ingestion_model": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "transformer": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "producer_release": { "$ref": "#/components/schemas/ConfigurationDeploymentProducerReleaseRef" }, "validation_evidence": { "$ref": "#/components/schemas/ConfigurationDeploymentTransformationEvidence" } } }, "ConfigurationDeploymentDocumentReleaseItem": { "type": "object", "additionalProperties": false, "required": [ "local_ref", "kind", "operation", "processing_kind", "name", "ingestion_model", "transformer", "template", "validation_evidence" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "kind": { "const": "release" }, "operation": { "const": "publish" }, "processing_kind": { "const": "document_generation" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "ingestion_model": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "transformer": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "template": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "producer_release": { "$ref": "#/components/schemas/ConfigurationDeploymentProducerReleaseRef" }, "validation_evidence": { "$ref": "#/components/schemas/ConfigurationDeploymentDocumentEvidence" } } }, "ConfigurationDeploymentReceiptTransformationReleaseItem": { "type": "object", "additionalProperties": false, "required": [ "local_ref", "kind", "operation", "processing_kind", "name", "ingestion_model", "transformer", "validation_evidence" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "kind": { "const": "release" }, "operation": { "const": "publish" }, "processing_kind": { "const": "transformation" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "ingestion_model": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "transformer": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "producer_release": { "$ref": "#/components/schemas/ConfigurationDeploymentProducerReleaseRef" }, "validation_evidence": { "$ref": "#/components/schemas/ConfigurationDeploymentReceiptTransformationEvidence" } } }, "ConfigurationDeploymentReceiptDocumentReleaseItem": { "type": "object", "additionalProperties": false, "required": [ "local_ref", "kind", "operation", "processing_kind", "name", "ingestion_model", "transformer", "template", "validation_evidence" ], "properties": { "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "kind": { "const": "release" }, "operation": { "const": "publish" }, "processing_kind": { "const": "document_generation" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "ingestion_model": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "transformer": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "template": { "$ref": "#/components/schemas/ConfigurationDeploymentResourceRef" }, "node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "$ref": "#/components/schemas/ConfigurationDeploymentNodeAddress" }, "producer_release": { "$ref": "#/components/schemas/ConfigurationDeploymentProducerReleaseRef" }, "validation_evidence": { "$ref": "#/components/schemas/ConfigurationDeploymentReceiptDocumentEvidence" } } }, "ConfigurationDeploymentManifest": { "type": "object", "additionalProperties": false, "x-docula-max-bytes": 2097152, "required": [ "schema", "items" ], "properties": { "schema": { "const": "docula-configuration-deployment-v1" }, "items": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "oneOf": [ { "$ref": "#/components/schemas/ConfigurationDeploymentIngestionModelItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentTransformerItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentTemplateItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentTransformationReleaseItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentDocumentReleaseItem" } ] } } } }, "ConfigurationDeploymentReceiptManifest": { "type": "object", "additionalProperties": false, "x-docula-max-bytes": 2097152, "required": [ "schema", "items" ], "properties": { "schema": { "const": "docula-configuration-deployment-v1" }, "items": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "oneOf": [ { "$ref": "#/components/schemas/ConfigurationDeploymentIngestionModelItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentTransformerItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentTemplateItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentReceiptTransformationReleaseItem" }, { "$ref": "#/components/schemas/ConfigurationDeploymentReceiptDocumentReleaseItem" } ] } } } }, "ConfigurationDeploymentValidationOutcome": { "type": "object", "additionalProperties": false, "required": [ "position", "local_ref", "resource_kind", "operation", "outcome", "dependencies" ], "properties": { "position": { "type": "integer", "minimum": 1, "maximum": 100 }, "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "resource_kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template", "release" ] }, "operation": { "type": "string", "enum": [ "deploy", "publish" ] }, "outcome": { "const": "validated" }, "content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "dependencies": { "type": "array", "maxItems": 100, "uniqueItems": true, "items": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" } } } }, "ConfigurationDeploymentValidation": { "type": "object", "additionalProperties": false, "x-docula-max-bytes": 528384, "required": [ "schema", "manifest_hash", "valid", "items", "errors", "correlation_id" ], "properties": { "schema": { "const": "docula-configuration-deployment-v1" }, "manifest_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "valid": { "type": "boolean" }, "items": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationDeploymentValidationOutcome" } }, "errors": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationIssue" } }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" } } }, "ConfigurationDeploymentDefinitionOutcome": { "type": "object", "additionalProperties": false, "required": [ "position", "local_ref", "resource_kind", "operation", "outcome", "resource_id", "family_id", "version_id", "activation_id", "slug", "revision", "content_hash", "effective_from", "created_at", "dependencies", "details" ], "properties": { "position": { "type": "integer", "minimum": 1, "maximum": 100 }, "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "resource_kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template" ] }, "operation": { "const": "deploy" }, "outcome": { "type": "string", "enum": [ "created", "reused", "scheduled" ] }, "resource_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "family_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "version_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "activation_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "slug": { "$ref": "#/components/schemas/ConfigurationDeploymentSlug" }, "revision": { "type": "integer", "minimum": 1 }, "content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "dependencies": { "type": "array", "maxItems": 0 }, "details": { "type": "object", "x-docula-max-bytes": 524288 } } }, "ConfigurationDeploymentReleaseOutcome": { "type": "object", "additionalProperties": false, "required": [ "position", "local_ref", "resource_kind", "operation", "outcome", "resource_id", "release_id", "content_hash", "published_at", "created_at", "dependencies", "details" ], "properties": { "position": { "type": "integer", "minimum": 1, "maximum": 100 }, "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "resource_kind": { "const": "release" }, "operation": { "const": "publish" }, "outcome": { "type": "string", "enum": [ "created", "reused" ] }, "resource_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "release_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "published_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "dependencies": { "type": "array", "maxItems": 100, "uniqueItems": true, "items": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" } }, "details": { "type": "object", "x-docula-max-bytes": 524288 } } }, "ConfigurationDeployment": { "type": "object", "additionalProperties": false, "required": [ "id", "schema", "created_by", "request_hash", "manifest_hash", "manifest", "status", "correlation_id", "created_at", "applied_at", "items" ], "properties": { "id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "schema": { "const": "docula-configuration-deployment-v1" }, "created_by": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "request_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "manifest_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "manifest": { "$ref": "#/components/schemas/ConfigurationDeploymentReceiptManifest" }, "status": { "const": "applied" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "applied_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "items": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "oneOf": [ { "$ref": "#/components/schemas/ConfigurationDeploymentDefinitionOutcome" }, { "$ref": "#/components/schemas/ConfigurationDeploymentReleaseOutcome" } ] } } } }, "ConfigurationDeploymentRead": { "type": "object", "additionalProperties": false, "x-docula-max-bytes": 528384, "required": [ "deployment", "correlation_id" ], "properties": { "deployment": { "$ref": "#/components/schemas/ConfigurationDeployment" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" } } }, "ConfigurationDeploymentMutationResult": { "type": "object", "additionalProperties": false, "x-docula-max-bytes": 528384, "required": [ "resource_kind", "resource_id", "result", "response_hash", "idempotent_replay", "correlation_id" ], "properties": { "resource_kind": { "const": "configuration_deployment" }, "resource_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "result": { "$ref": "#/components/schemas/ConfigurationDeployment" }, "response_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "idempotent_replay": { "type": "boolean" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" } } }, "User": { "type": "object", "additionalProperties": false, "required": [ "id", "username", "roles" ], "properties": { "id": { "type": "string", "minLength": 1 }, "username": { "type": "string", "minLength": 1 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "administrator", "engineer", "operator", "auditor", "business_viewer" ] }, "uniqueItems": true } } }, "Session": { "type": "object", "additionalProperties": false, "required": [ "user", "must_change_password", "expires_at", "csrf_token" ], "properties": { "user": { "$ref": "#/components/schemas/User" }, "must_change_password": { "type": "boolean" }, "expires_at": { "type": "string", "format": "date-time" }, "csrf_token": { "type": "string", "minLength": 1 } } }, "Live": { "type": "object", "additionalProperties": false, "required": [ "status", "version", "commit" ], "properties": { "status": { "type": "string", "const": "live" }, "version": { "type": "string", "minLength": 1 }, "commit": { "type": "string", "minLength": 1 } } }, "PublicDependency": { "type": "object", "additionalProperties": false, "required": [ "name", "status" ], "properties": { "name": { "type": "string", "enum": [ "postgresql", "nats", "s3", "outbox" ] }, "status": { "type": "string", "enum": [ "ready", "unavailable" ] } } }, "PublicReadiness": { "type": "object", "additionalProperties": false, "required": [ "status", "dependencies" ], "properties": { "status": { "type": "string", "enum": [ "ready", "unavailable" ] }, "dependencies": { "type": "array", "minItems": 3, "maxItems": 4, "items": { "$ref": "#/components/schemas/PublicDependency" } } } }, "Dependency": { "type": "object", "additionalProperties": false, "required": [ "name", "operation", "status" ], "properties": { "name": { "type": "string", "enum": [ "postgresql", "nats", "s3", "outbox" ] }, "operation": { "type": "string", "enum": [ "select_one", "connect_flush_jetstream_account_info", "put_get_verify_delete", "outbox_backlog" ] }, "status": { "type": "string", "enum": [ "ready", "unavailable" ] }, "failure": { "type": "string", "enum": [ "unavailable", "denied", "corrupt", "timed_out", "backlog_stale" ] }, "duration_ms": { "type": "integer", "minimum": 0 }, "remediation": { "type": "string" }, "outbox": { "$ref": "#/components/schemas/OutboxStatus" } } }, "OutboxStatus": { "description": "Background-loop counters of the durable outbox. Present only on the outbox dependency; readiness reports backlog_stale when the oldest unpublished event is older than five minutes.", "type": "object", "additionalProperties": false, "required": [ "backlog_size", "oldest_unpublished_age_seconds", "publish_failures" ], "properties": { "backlog_size": { "type": "integer", "minimum": 0 }, "oldest_unpublished_age_seconds": { "type": "integer", "minimum": 0 }, "consumer_last_success_at": { "type": "string", "format": "date-time" }, "publish_failures": { "type": "integer", "minimum": 0 } } }, "Readiness": { "type": "object", "additionalProperties": false, "required": [ "status", "dependencies" ], "properties": { "status": { "type": "string", "enum": [ "ready", "unavailable" ] }, "dependencies": { "type": "array", "minItems": 3, "maxItems": 4, "items": { "$ref": "#/components/schemas/Dependency" } } } }, "LoginRequest": { "type": "object", "additionalProperties": false, "required": [ "username", "password" ], "properties": { "username": { "type": "string", "minLength": 1, "maxLength": 254 }, "password": { "type": "string", "minLength": 15, "maxLength": 128 } } }, "PasswordChangeRequest": { "type": "object", "additionalProperties": false, "required": [ "current_password", "new_password" ], "properties": { "current_password": { "type": "string", "minLength": 15, "maxLength": 128 }, "new_password": { "type": "string", "minLength": 15, "maxLength": 128 } } }, "CreateContractRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "description", "schema" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "schema": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 } } }, "UpdateContractRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "description", "schema", "expected_revision" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "schema": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 }, "expected_revision": { "type": "integer", "minimum": 1 } } }, "ValidateContractRequest": { "type": "object", "additionalProperties": false, "required": [ "schema" ], "properties": { "schema": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 } } }, "RevisionRequest": { "type": "object", "additionalProperties": false, "required": [ "expected_revision" ], "properties": { "expected_revision": { "type": "integer", "minimum": 1 } } }, "EmptyObject": { "type": "object", "additionalProperties": false, "maxProperties": 0 }, "ContractSummary": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "description", "draft_revision", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 1 }, "latest_version_number": { "type": "integer", "minimum": 1 }, "latest_status": { "type": "string", "enum": [ "versioned", "published", "deprecated" ] }, "updated_at": { "type": "string", "format": "date-time" } } }, "ContractVersion": { "type": "object", "additionalProperties": false, "required": [ "id", "contract_id", "number", "schema", "content_hash", "status", "source_revision", "created_by", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "contract_id": { "type": "string", "format": "uuid" }, "number": { "type": "integer", "minimum": 1 }, "schema": { "type": "string", "minLength": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "type": "string", "enum": [ "versioned", "published", "deprecated" ] }, "source_revision": { "type": "integer", "minimum": 1 }, "created_by": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "published_at": { "type": "string", "format": "date-time" }, "deprecated_at": { "type": "string", "format": "date-time" } } }, "Contract": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "description", "draft_revision", "created_by", "created_at", "updated_at", "versions" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_schema": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 1 }, "created_by": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "versions": { "type": "array", "items": { "$ref": "#/components/schemas/ContractVersion" } } } }, "ContractList": { "type": "object", "additionalProperties": false, "required": [ "contracts" ], "properties": { "contracts": { "type": "array", "items": { "$ref": "#/components/schemas/ContractSummary" } } } }, "ContractMutation": { "type": "object", "additionalProperties": false, "required": [ "contract", "correlation_id" ], "properties": { "contract": { "$ref": "#/components/schemas/Contract" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "VersionMutation": { "type": "object", "additionalProperties": false, "required": [ "version", "correlation_id" ], "properties": { "version": { "$ref": "#/components/schemas/ContractVersion" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "GenerateCaseRequest": { "type": "object", "additionalProperties": false, "required": [ "contract_version_id", "kind", "seed" ], "properties": { "contract_version_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "valid", "boundary", "invalid" ] }, "seed": { "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "ImportCaseRequest": { "type": "object", "additionalProperties": false, "required": [ "contract_version_id", "kind", "payload" ], "properties": { "contract_version_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "valid", "boundary" ] }, "payload": { "x-docula-max-bytes": 524288 } } }, "CaseFields": { "type": "object", "required": [ "id", "contract_id", "contract_version_id", "contract_version_number", "contract_hash", "kind", "content_hash", "seed", "provider", "provider_version", "locale", "generator_version", "created_by", "correlation_id", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "contract_id": { "type": "string", "format": "uuid" }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_version_number": { "type": "integer", "minimum": 1 }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "kind": { "type": "string", "enum": [ "valid", "boundary", "invalid" ] }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "seed": { "type": "integer", "minimum": 0, "maximum": 2147483647 }, "provider": { "type": "string", "enum": [ "Faker", "Docula fixture" ] }, "provider_version": { "type": "string", "enum": [ "40.28.1", "1" ] }, "locale": { "type": "string", "enum": [ "en_US", "synthetic" ] }, "generator_version": { "type": "string", "enum": [ "docula-json-schema-v1", "docula-fixture-import-v1" ] }, "invalid_path": { "type": "string" }, "invalid_keyword": { "type": "string" }, "created_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1 }, "created_at": { "type": "string", "format": "date-time" } } }, "CaseSummary": { "allOf": [ { "$ref": "#/components/schemas/CaseFields" } ], "unevaluatedProperties": false }, "Case": { "unevaluatedProperties": false, "allOf": [ { "$ref": "#/components/schemas/CaseFields" }, { "type": "object", "required": [ "payload" ], "properties": { "payload": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 } } } ] }, "CaseList": { "type": "object", "additionalProperties": false, "required": [ "cases" ], "properties": { "cases": { "type": "array", "items": { "$ref": "#/components/schemas/CaseSummary" } } } }, "TransformSourceFormat": { "type": "string", "enum": [ "yaml", "json" ] }, "CreateTransformRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "description", "source", "format" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" } } }, "UpdateTransformRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "description", "source", "format", "expected_revision" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" }, "expected_revision": { "type": "integer", "minimum": 1 } } }, "ValidateTransformRequest": { "type": "object", "additionalProperties": false, "required": [ "source", "format" ], "properties": { "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" } } }, "PreviewTransformRequest": { "type": "object", "additionalProperties": false, "required": [ "source", "format", "case_id" ], "properties": { "source": { "type": "string", "minLength": 1, "x-docula-max-bytes": 262144 }, "format": { "$ref": "#/components/schemas/TransformSourceFormat" }, "case_id": { "type": "string", "format": "uuid" } } }, "TransformSummary": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "description", "draft_revision", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 1 }, "latest_version_number": { "type": "integer", "minimum": 1 }, "latest_status": { "type": "string", "enum": [ "versioned", "published" ] }, "updated_at": { "type": "string", "format": "date-time" } } }, "TransformVersion": { "type": "object", "additionalProperties": false, "required": [ "id", "definition_id", "number", "source", "source_format", "canonical_definition", "content_hash", "language", "status", "source_revision", "created_by", "correlation_id", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "definition_id": { "type": "string", "format": "uuid" }, "number": { "type": "integer", "minimum": 1 }, "source": { "type": "string", "minLength": 1 }, "source_format": { "$ref": "#/components/schemas/TransformSourceFormat" }, "canonical_definition": { "type": "string", "minLength": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "language": { "type": "string", "const": "declarative-v1" }, "status": { "type": "string", "enum": [ "versioned", "published" ] }, "source_revision": { "type": "integer", "minimum": 1 }, "created_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "created_at": { "type": "string", "format": "date-time" }, "published_at": { "type": "string", "format": "date-time" } } }, "Transform": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "description", "draft_revision", "created_by", "created_at", "updated_at", "versions" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_source": { "type": "string" }, "draft_format": { "$ref": "#/components/schemas/TransformSourceFormat" }, "draft_revision": { "type": "integer", "minimum": 1 }, "created_by": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "versions": { "type": "array", "items": { "$ref": "#/components/schemas/TransformVersion" } } } }, "TransformList": { "type": "object", "additionalProperties": false, "required": [ "transforms" ], "properties": { "transforms": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/TransformSummary" } }, "next_cursor": { "type": "string", "minLength": 1, "maxLength": 256 } } }, "TransformMutation": { "type": "object", "additionalProperties": false, "required": [ "transform", "correlation_id" ], "properties": { "transform": { "$ref": "#/components/schemas/Transform" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "TransformVersionMutation": { "type": "object", "additionalProperties": false, "required": [ "version", "correlation_id" ], "properties": { "version": { "$ref": "#/components/schemas/TransformVersion" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "TransformValidationError": { "type": "object", "additionalProperties": false, "required": [ "path", "message" ], "properties": { "path": { "type": "string" }, "message": { "type": "string", "minLength": 1, "maxLength": 500 }, "line": { "type": "integer", "minimum": 1 }, "column": { "type": "integer", "minimum": 1 } } }, "TransformValidation": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors" ], "properties": { "valid": { "type": "boolean" }, "errors": { "type": "array", "maxItems": 20, "items": { "$ref": "#/components/schemas/TransformValidationError" } } } }, "TransformPreview": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors", "case_id", "case_hash", "output", "output_hash", "correlation_id" ], "properties": { "valid": { "type": "boolean", "const": true }, "errors": { "type": "array", "maxItems": 0 }, "case_id": { "type": "string", "format": "uuid" }, "case_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "output": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 }, "output_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "TransformValidationProblem": { "type": "object", "additionalProperties": false, "required": [ "type", "title", "status", "code", "detail", "correlation_id", "errors" ], "properties": { "type": { "type": "string", "const": "/problems/validation_failed" }, "title": { "type": "string", "minLength": 1 }, "status": { "type": "integer", "const": 422 }, "code": { "type": "string", "const": "validation_failed" }, "detail": { "type": "string", "minLength": 1 }, "correlation_id": { "type": "string", "minLength": 1 }, "errors": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "$ref": "#/components/schemas/TransformValidationError" } } } }, "CreateTemplateRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "description", "file" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "file": { "type": "string", "format": "binary", "x-docula-max-bytes": 10485760 } } }, "CreateTemplateVersionRequest": { "type": "object", "additionalProperties": false, "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary", "x-docula-max-bytes": 10485760 } } }, "TemplateSummary": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "description", "draft_revision", "latest_version_number", "latest_content_hash", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "draft_revision": { "type": "integer", "minimum": 0 }, "latest_version_number": { "type": "integer", "minimum": 0 }, "latest_content_hash": { "oneOf": [ { "type": "string", "const": "" }, { "type": "string", "pattern": "^[0-9a-f]{64}$" } ] }, "updated_at": { "type": "string", "format": "date-time" } } }, "TemplateDraftState": { "type": "object", "additionalProperties": false, "required": [ "revision", "original_filename", "media_type", "byte_size", "content_hash", "bindings", "updated_by", "verified_at" ], "properties": { "revision": { "type": "integer", "minimum": 1 }, "original_filename": { "type": "string", "minLength": 1, "maxLength": 255 }, "media_type": { "type": "string", "const": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "type": "string", "pattern": "^/", "maxLength": 256 } }, "updated_by": { "type": "string", "format": "uuid" }, "verified_at": { "type": "string", "format": "date-time" } } }, "TemplateVersion": { "type": "object", "additionalProperties": false, "required": [ "id", "template_id", "number", "original_filename", "media_type", "byte_size", "content_hash", "bindings", "created_by", "correlation_id", "created_at", "status" ], "properties": { "id": { "type": "string", "format": "uuid" }, "template_id": { "type": "string", "format": "uuid" }, "number": { "type": "integer", "minimum": 1 }, "original_filename": { "type": "string", "minLength": 1, "maxLength": 255 }, "media_type": { "type": "string", "const": "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "type": "string", "pattern": "^/", "maxLength": 256 } }, "created_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1 }, "created_at": { "type": "string", "format": "date-time" }, "source_revision": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "versioned", "published" ] }, "published_at": { "type": "string", "format": "date-time" } } }, "Template": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "description", "created_by", "created_at", "updated_at", "versions" ], "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "description": { "type": "string" }, "created_by": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "draft": { "$ref": "#/components/schemas/TemplateDraftState" }, "versions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/TemplateVersion" } } } }, "TemplateList": { "type": "object", "additionalProperties": false, "required": [ "templates" ], "properties": { "templates": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/TemplateSummary" } }, "next_cursor": { "type": "string", "minLength": 1, "maxLength": 256 } } }, "TemplateMutation": { "type": "object", "additionalProperties": false, "required": [ "template", "correlation_id" ], "properties": { "template": { "$ref": "#/components/schemas/Template" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "TemplateVersionMutation": { "type": "object", "additionalProperties": false, "required": [ "version", "correlation_id" ], "properties": { "version": { "$ref": "#/components/schemas/TemplateVersion" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "TemplatePreviewRequest": { "type": "object", "additionalProperties": false, "required": [ "transform_version_id", "case_id" ], "properties": { "transform_version_id": { "type": "string", "format": "uuid" }, "case_id": { "type": "string", "format": "uuid" } } }, "ResolvedBinding": { "type": "object", "additionalProperties": false, "required": [ "pointer", "value" ], "properties": { "pointer": { "type": "string", "pattern": "^/" }, "value": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] } } }, "TemplatePreview": { "type": "object", "additionalProperties": false, "required": [ "template_version_id", "template_hash", "transform_version_id", "transform_hash", "case_id", "case_hash", "output_hash", "bindings", "bindings_hash", "preview_hash", "correlation_id" ], "properties": { "template_version_id": { "type": "string", "format": "uuid" }, "template_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "transform_version_id": { "type": "string", "format": "uuid" }, "transform_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "case_id": { "type": "string", "format": "uuid" }, "case_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "output_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/ResolvedBinding" } }, "bindings_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "preview_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "PublishReleaseRequest": { "type": "object", "additionalProperties": false, "required": [ "name", "description", "contract_version_id", "transform_version_id", "template_version_id", "case_id" ], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "maxLength": 2000 }, "contract_version_id": { "type": "string", "format": "uuid" }, "transform_version_id": { "type": "string", "format": "uuid" }, "template_version_id": { "type": "string", "format": "uuid" }, "case_id": { "type": "string", "format": "uuid" } } }, "Release": { "type": "object", "additionalProperties": false, "required": [ "id", "processing_kind", "name", "description", "contract_version_id", "contract_hash", "transform_version_id", "transform_hash", "output_hash", "manifest", "content_hash", "created_by", "correlation_id", "published_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "processing_kind": { "type": "string", "enum": [ "transformation", "document_generation" ] }, "name": { "type": "string" }, "description": { "type": "string" }, "ingestion_model_version_id": { "type": "string", "format": "uuid" }, "ingestion_model_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "node_address": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$", "maxLength": 1024 }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$", "maxLength": 1024 }, "producer_release_id": { "type": "string", "format": "uuid" }, "producer_release_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "validation_input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "contract_version_id": { "type": "string", "format": "uuid" }, "contract_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "transform_version_id": { "type": "string", "format": "uuid" }, "transform_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "template_version_id": { "type": "string", "format": "uuid" }, "template_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "validation_case_id": { "type": "string", "format": "uuid" }, "case_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "output_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "bindings_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "manifest": { "type": "string", "minLength": 1 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1 }, "published_at": { "type": "string", "format": "date-time" } }, "allOf": [ { "if": { "properties": { "processing_kind": { "const": "document_generation" } }, "required": [ "processing_kind" ] }, "then": { "required": [ "template_version_id", "template_hash", "bindings_hash" ] } }, { "if": { "properties": { "processing_kind": { "const": "transformation" } }, "required": [ "processing_kind" ] }, "then": { "not": { "anyOf": [ { "required": [ "template_version_id" ] }, { "required": [ "template_hash" ] }, { "required": [ "bindings_hash" ] } ] } } }, { "oneOf": [ { "required": [ "validation_case_id", "case_hash" ], "not": { "required": [ "node_address" ] } }, { "required": [ "ingestion_model_version_id", "ingestion_model_hash", "node_address", "input_mode", "validation_input_hash", "validation_case_id", "case_hash" ], "properties": { "input_mode": { "const": "submission" } } }, { "required": [ "ingestion_model_version_id", "ingestion_model_hash", "node_address", "input_mode", "producer_node_address", "producer_release_id", "producer_release_hash", "validation_input_hash" ], "properties": { "input_mode": { "const": "parent_output" } }, "not": { "anyOf": [ { "required": [ "validation_case_id" ] }, { "required": [ "case_hash" ] } ] } } ] } ] }, "ReleaseList": { "type": "object", "additionalProperties": false, "required": [ "releases" ], "properties": { "releases": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/Release" } } } }, "ReleaseMutation": { "type": "object", "additionalProperties": false, "required": [ "release", "correlation_id" ], "properties": { "release": { "$ref": "#/components/schemas/Release" }, "correlation_id": { "type": "string", "minLength": 1 } } }, "SubmitExecutionRequest": { "type": "object", "additionalProperties": false, "required": [ "release_id", "input" ], "properties": { "release_id": { "type": "string", "format": "uuid" }, "metadata": { "$ref": "#/components/schemas/IntakeMetadata" }, "input": { "x-docula-max-bytes": 524288 } } }, "IntakeMetadata": { "type": "object", "additionalProperties": false, "required": [ "schema", "source_object", "source_timestamp", "source_actor", "source_system", "fixture_family", "scenario_id", "schedule_interval_months" ], "properties": { "schema": { "type": "string", "const": "docula-intake-metadata-v1" }, "source_object": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" }, "source_timestamp": { "type": "string", "minLength": 1, "maxLength": 64 }, "source_actor": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "source_system": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$" }, "fixture_family": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$" }, "scenario_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$" }, "schedule_interval_months": { "type": "integer", "enum": [ 1, 6, 12 ] } } }, "ExecutionIssue": { "type": "object", "additionalProperties": false, "required": [ "path", "message" ], "properties": { "path": { "type": "string", "maxLength": 512 }, "keyword": { "type": "string", "maxLength": 64 }, "message": { "type": "string", "minLength": 1, "maxLength": 240 } } }, "ExecutionFailure": { "type": "object", "additionalProperties": false, "required": [ "code", "message", "issues" ], "properties": { "code": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,63}$" }, "message": { "type": "string", "minLength": 1, "maxLength": 240 }, "issues": { "type": "array", "maxItems": 20, "items": { "$ref": "#/components/schemas/ExecutionIssue" } } } }, "ExecutionStep": { "type": "object", "additionalProperties": false, "required": [ "name", "position", "status", "attempt", "state_version" ], "properties": { "name": { "type": "string", "enum": [ "validate", "transform.declarative", "compose", "render" ] }, "position": { "type": "integer", "minimum": 1, "maximum": 4 }, "status": { "type": "string", "enum": [ "not_started", "queued", "running", "succeeded", "failed" ] }, "attempt": { "type": "integer", "minimum": 0, "maximum": 5 }, "state_version": { "type": "integer", "minimum": 1 }, "started_at": { "type": "string", "format": "date-time" }, "finished_at": { "type": "string", "format": "date-time" }, "duration_ms": { "type": "integer", "minimum": 0 }, "summary": { "type": "object" }, "failure": { "$ref": "#/components/schemas/ExecutionFailure" } } }, "ExecutionArtifact": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "media_type", "byte_size", "content_hash", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "docx", "pdf" ] }, "media_type": { "type": "string", "enum": [ "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/pdf" ] }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 26214400 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string", "format": "date-time" } } }, "Execution": { "type": "object", "additionalProperties": false, "required": [ "id", "release_id", "release_hash", "processing_kind", "input_hash", "raw_input_hash", "status", "submitted_by", "correlation_id", "created_at", "updated_at", "steps", "artifacts" ], "properties": { "id": { "type": "string", "format": "uuid" }, "release_id": { "type": "string", "format": "uuid" }, "release_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "processing_kind": { "type": "string", "enum": [ "transformation", "document_generation" ] }, "submission_id": { "type": "string", "format": "uuid" }, "processing_node_id": { "type": "string", "format": "uuid" }, "input": { "x-docula-max-bytes": 524288 }, "input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "raw_input": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 }, "raw_input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "metadata": { "$ref": "#/components/schemas/IntakeMetadata" }, "output": { "x-docula-max-bytes": 524288 }, "output_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "status": { "type": "string", "enum": [ "queued", "processing", "awaiting_compose", "completed", "failed" ] }, "submitted_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "completed_at": { "type": "string", "format": "date-time" }, "steps": { "type": "array", "minItems": 2, "maxItems": 4, "items": { "$ref": "#/components/schemas/ExecutionStep" } }, "artifacts": { "type": "array", "maxItems": 2, "items": { "$ref": "#/components/schemas/ExecutionArtifact" } } } }, "ExecutionList": { "type": "object", "additionalProperties": false, "required": [ "executions" ], "properties": { "executions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/Execution" } }, "next_cursor": { "type": "string", "format": "uuid" } } }, "ExecutionMutation": { "type": "object", "additionalProperties": false, "required": [ "execution", "correlation_id", "idempotent_replay" ], "properties": { "execution": { "$ref": "#/components/schemas/Execution" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "idempotent_replay": { "type": "boolean" } } }, "AnalyticsDurationPercentiles": { "type": "object", "additionalProperties": false, "required": [ "sample_count", "p50_ms", "p95_ms" ], "properties": { "sample_count": { "type": "integer", "minimum": 0 }, "p50_ms": { "type": [ "integer", "null" ], "minimum": 0 }, "p95_ms": { "type": [ "integer", "null" ], "minimum": 0 } } }, "AnalyticsRSSPercentiles": { "type": "object", "additionalProperties": false, "required": [ "measured_count", "unavailable_count", "p50_bytes", "p95_bytes" ], "properties": { "measured_count": { "type": "integer", "minimum": 0 }, "unavailable_count": { "type": "integer", "minimum": 0 }, "p50_bytes": { "type": [ "integer", "null" ], "minimum": 0 }, "p95_bytes": { "type": [ "integer", "null" ], "minimum": 0 } } }, "AnalyticsSubmissionSummary": { "type": "object", "additionalProperties": false, "required": [ "count", "raw_bytes" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "raw_bytes": { "type": "integer", "minimum": 0 } } }, "AnalyticsIngestionSummary": { "type": "object", "additionalProperties": false, "required": [ "accepted_count", "rejected_count", "no_processing_count", "decision_latency" ], "properties": { "accepted_count": { "type": "integer", "minimum": 0 }, "rejected_count": { "type": "integer", "minimum": 0 }, "no_processing_count": { "type": "integer", "minimum": 0 }, "decision_latency": { "$ref": "#/components/schemas/AnalyticsDurationPercentiles" } } }, "AnalyticsProcessingSummary": { "type": "object", "additionalProperties": false, "required": [ "planned_count", "attempted_count", "completed_count", "failed_count", "derived_blocked_count", "duration", "peak_rss" ], "properties": { "planned_count": { "type": "integer", "minimum": 0 }, "attempted_count": { "type": "integer", "minimum": 0 }, "completed_count": { "type": "integer", "minimum": 0 }, "failed_count": { "type": "integer", "minimum": 0 }, "derived_blocked_count": { "type": "integer", "minimum": 0 }, "duration": { "$ref": "#/components/schemas/AnalyticsDurationPercentiles" }, "peak_rss": { "$ref": "#/components/schemas/AnalyticsRSSPercentiles" } } }, "AnalyticsProcessingLoadPhase": { "type": "object", "additionalProperties": false, "required": [ "duration_ms", "operation_count", "average_duration_ms" ], "properties": { "duration_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "operation_count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "average_duration_ms": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 9007199254740991 } } }, "AnalyticsProcessingLoadBucket": { "type": "object", "additionalProperties": false, "required": [ "bucket_start", "ingestion", "transformation", "docx_composition", "pdf_generation" ], "properties": { "bucket_start": { "type": "string", "format": "date-time" }, "ingestion": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" }, "transformation": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" }, "docx_composition": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" }, "pdf_generation": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" } } }, "AnalyticsProcessingLoad": { "type": "object", "additionalProperties": false, "required": [ "bucket_width_seconds", "buckets" ], "properties": { "bucket_width_seconds": { "type": "integer", "minimum": 1, "maximum": 31622400 }, "buckets": { "type": "array", "minItems": 1, "maxItems": 366, "items": { "$ref": "#/components/schemas/AnalyticsProcessingLoadBucket" } } } }, "AnalyticsStorageSummary": { "type": "object", "additionalProperties": false, "required": [ "docx_count", "docx_bytes", "pdf_count", "pdf_bytes" ], "properties": { "docx_count": { "type": "integer", "minimum": 0 }, "docx_bytes": { "type": "integer", "minimum": 0 }, "pdf_count": { "type": "integer", "minimum": 0 }, "pdf_bytes": { "type": "integer", "minimum": 0 } } }, "AnalyticsFailureCount": { "type": "object", "additionalProperties": false, "required": [ "code", "count" ], "properties": { "code": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,63}$" }, "count": { "type": "integer", "minimum": 1 } } }, "AnalyticsRate": { "type": "object", "additionalProperties": false, "required": [ "numerator", "denominator", "value" ], "properties": { "numerator": { "type": "integer", "minimum": 0 }, "denominator": { "type": "integer", "minimum": 0 }, "value": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } } }, "AnalyticsRates": { "type": "object", "additionalProperties": false, "required": [ "ingestion_acceptance", "processing_completion", "processing_failure" ], "properties": { "ingestion_acceptance": { "$ref": "#/components/schemas/AnalyticsRate" }, "processing_completion": { "$ref": "#/components/schemas/AnalyticsRate" }, "processing_failure": { "$ref": "#/components/schemas/AnalyticsRate" } } }, "AnalyticsDocumentQueueSnapshot": { "type": "object", "additionalProperties": false, "required": [ "observed_at", "pending_count", "in_flight_count", "availability", "scope", "method" ], "properties": { "observed_at": { "type": "string", "format": "date-time" }, "pending_count": { "type": "integer", "minimum": 0 }, "in_flight_count": { "type": "integer", "minimum": 0 }, "availability": { "type": "string", "enum": [ "available", "unavailable" ] }, "scope": { "type": "string", "const": "document_compose_and_render" }, "method": { "type": "string", "const": "jetstream_consumer_info" } }, "allOf": [ { "if": { "properties": { "availability": { "const": "unavailable" } }, "required": [ "availability" ] }, "then": { "properties": { "pending_count": { "const": 0 }, "in_flight_count": { "const": 0 } } } } ] }, "AnalyticsDocumentWorkerSnapshot": { "type": "object", "additionalProperties": false, "required": [ "observed_at", "responsive_replicas", "busy_slots", "capacity_slots", "saturation_ratio", "availability", "scope", "method" ], "properties": { "observed_at": { "type": "string", "format": "date-time" }, "responsive_replicas": { "type": "integer", "minimum": 0 }, "busy_slots": { "type": "integer", "minimum": 0 }, "capacity_slots": { "type": "integer", "minimum": 0 }, "saturation_ratio": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "availability": { "type": "string", "enum": [ "available", "unavailable" ] }, "scope": { "type": "string", "const": "document_worker_replicas" }, "method": { "type": "string", "const": "bounded_nats_broadcast" } }, "allOf": [ { "if": { "properties": { "availability": { "const": "available" }, "capacity_slots": { "minimum": 1 } }, "required": [ "availability", "capacity_slots" ] }, "then": { "properties": { "saturation_ratio": { "type": "number", "minimum": 0, "maximum": 1 } } }, "else": { "properties": { "saturation_ratio": { "type": "null" } } } } ] }, "AnalyticsDocumentGenerationSummary": { "type": "object", "additionalProperties": false, "required": [ "completed_render_count", "window_minutes", "documents_per_minute", "render_latency", "render_attempt_error_rate", "peak_rss", "queue", "workers" ], "properties": { "completed_render_count": { "type": "integer", "minimum": 0 }, "window_minutes": { "type": "number", "exclusiveMinimum": 0 }, "documents_per_minute": { "type": [ "number", "null" ], "minimum": 0 }, "render_latency": { "$ref": "#/components/schemas/AnalyticsDurationPercentiles" }, "render_attempt_error_rate": { "$ref": "#/components/schemas/AnalyticsRate" }, "peak_rss": { "$ref": "#/components/schemas/AnalyticsRSSPercentiles" }, "queue": { "$ref": "#/components/schemas/AnalyticsDocumentQueueSnapshot" }, "workers": { "$ref": "#/components/schemas/AnalyticsDocumentWorkerSnapshot" } }, "allOf": [ { "if": { "properties": { "completed_render_count": { "const": 0 } }, "required": [ "completed_render_count" ] }, "then": { "properties": { "documents_per_minute": { "type": "null" } } }, "else": { "properties": { "documents_per_minute": { "type": "number", "minimum": 0 } } } } ] }, "AnalyticsSummary": { "type": "object", "additionalProperties": false, "required": [ "from", "to", "submissions", "ingestion", "processing", "processing_load", "storage", "rates", "failures", "percentile_method", "document_generation" ], "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "submissions": { "$ref": "#/components/schemas/AnalyticsSubmissionSummary" }, "ingestion": { "$ref": "#/components/schemas/AnalyticsIngestionSummary" }, "processing": { "$ref": "#/components/schemas/AnalyticsProcessingSummary" }, "processing_load": { "$ref": "#/components/schemas/AnalyticsProcessingLoad" }, "storage": { "$ref": "#/components/schemas/AnalyticsStorageSummary" }, "rates": { "$ref": "#/components/schemas/AnalyticsRates" }, "failures": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/AnalyticsFailureCount" } }, "percentile_method": { "type": "string", "const": "nearest_rank" }, "document_generation": { "$ref": "#/components/schemas/AnalyticsDocumentGenerationSummary" } } }, "AnalyticsDecisionProcessingLoadBucket": { "type": "object", "additionalProperties": false, "required": [ "bucket_start", "bucket_width_seconds", "ingestion", "transformation", "docx_composition", "pdf_generation" ], "properties": { "bucket_start": { "type": "string", "format": "date-time" }, "bucket_width_seconds": { "type": "integer", "minimum": 3600, "maximum": 86400, "multipleOf": 3600 }, "ingestion": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" }, "transformation": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" }, "docx_composition": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" }, "pdf_generation": { "$ref": "#/components/schemas/AnalyticsProcessingLoadPhase" } } }, "AnalyticsDecisionProcessingLoad": { "type": "object", "description": "Activity-time evidence grouped by the first canonical terminal timestamp; it is not a submission-receipt cohort or a capacity estimate.", "additionalProperties": false, "required": [ "nominal_bucket_width_seconds", "buckets" ], "properties": { "nominal_bucket_width_seconds": { "type": "integer", "enum": [ 3600, 21600, 86400 ] }, "buckets": { "type": "array", "minItems": 1, "maxItems": 366, "items": { "$ref": "#/components/schemas/AnalyticsDecisionProcessingLoadBucket" } } } }, "AnalyticsDecisionPeriod": { "type": "object", "description": "Business facts for submissions received in the half-open UTC cohort [from,to). Assessment is only the interval assessment of that cohort, never readiness or global health.", "additionalProperties": false, "required": [ "from", "to", "submissions", "ingestion", "pending_ingestion_count", "processing", "generated_set_count", "storage", "affected_submissions", "assessment", "processing_load" ], "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "submissions": { "$ref": "#/components/schemas/AnalyticsSubmissionSummary" }, "ingestion": { "$ref": "#/components/schemas/AnalyticsIngestionSummary" }, "processing": { "$ref": "#/components/schemas/AnalyticsProcessingSummary" }, "generated_set_count": { "type": "integer", "minimum": 0 }, "storage": { "$ref": "#/components/schemas/AnalyticsStorageSummary" }, "pending_ingestion_count": { "type": "integer", "minimum": 0 }, "affected_submissions": { "$ref": "#/components/schemas/AnalyticsDecisionRate" }, "assessment": { "type": "string", "enum": [ "no_activity", "in_progress", "clear", "attention" ] }, "processing_load": { "$ref": "#/components/schemas/AnalyticsDecisionProcessingLoad" } } }, "AnalyticsDecisionRate": { "type": "object", "additionalProperties": false, "required": [ "numerator", "denominator", "value", "availability", "reason" ], "properties": { "numerator": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "denominator": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "value": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 }, "availability": { "type": "string", "enum": [ "available", "unavailable" ] }, "reason": { "type": [ "string", "null" ] } }, "oneOf": [ { "properties": { "availability": { "const": "available" }, "value": { "type": "number" }, "reason": { "type": "null" } } }, { "properties": { "availability": { "const": "unavailable" }, "value": { "type": "null" }, "reason": { "type": "string", "const": "no_submissions" } } } ] }, "AnalyticsComparisonState": { "type": "object", "additionalProperties": false, "required": [ "availability", "reason" ], "properties": { "availability": { "type": "string", "enum": [ "available", "unavailable" ] }, "reason": { "type": [ "string", "null" ] } }, "oneOf": [ { "properties": { "availability": { "const": "available" }, "reason": { "type": "null" } } }, { "properties": { "availability": { "const": "unavailable" }, "reason": { "type": "string", "enum": [ "previous_count_zero", "current_period_has_no_attempted_nodes", "previous_period_has_no_attempted_nodes", "current_period_has_no_submissions", "previous_period_has_no_submissions" ] } } } ] }, "AnalyticsComparisonPair": { "type": "object", "additionalProperties": false, "required": [ "count", "rate" ], "properties": { "count": { "$ref": "#/components/schemas/AnalyticsComparisonState" }, "rate": { "$ref": "#/components/schemas/AnalyticsComparisonState" } } }, "AnalyticsDecisionComparisons": { "type": "object", "additionalProperties": false, "required": [ "submissions", "processing_completion", "generated_sets", "affected_submissions" ], "properties": { "submissions": { "$ref": "#/components/schemas/AnalyticsComparisonState" }, "processing_completion": { "$ref": "#/components/schemas/AnalyticsComparisonState" }, "generated_sets": { "$ref": "#/components/schemas/AnalyticsComparisonState" }, "affected_submissions": { "$ref": "#/components/schemas/AnalyticsComparisonState" } } }, "AnalyticsErrorGroupFact": { "type": "object", "description": "One non-additive scope/code fact. Groups may overlap; never sum them to derive distinct affected submissions.", "additionalProperties": false, "required": [ "scope", "code", "affected_submission_count", "affected_node_count", "submission_denominator", "rate" ], "properties": { "scope": { "type": "string", "enum": [ "ingestion_rejection", "processing_failure", "blocked_dependency" ] }, "code": { "type": "string", "minLength": 1, "maxLength": 128 }, "affected_submission_count": { "type": "integer", "minimum": 0 }, "affected_node_count": { "type": [ "integer", "null" ], "minimum": 0 }, "submission_denominator": { "type": "integer", "minimum": 0 }, "rate": { "$ref": "#/components/schemas/AnalyticsDecisionRate" } }, "oneOf": [ { "properties": { "scope": { "const": "ingestion_rejection" }, "code": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z0-9]+(?:_[a-z0-9]+)*$" }, "affected_node_count": { "type": "null" } } }, { "properties": { "scope": { "enum": [ "processing_failure", "blocked_dependency" ] }, "code": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z][a-z0-9_.-]{0,63}$" }, "affected_node_count": { "type": "integer", "minimum": 0 } } } ] }, "AnalyticsComparedErrorGroup": { "type": "object", "additionalProperties": false, "required": [ "current", "previous", "comparison" ], "properties": { "current": { "$ref": "#/components/schemas/AnalyticsErrorGroupFact" }, "previous": { "$ref": "#/components/schemas/AnalyticsErrorGroupFact" }, "comparison": { "$ref": "#/components/schemas/AnalyticsComparisonPair" } } }, "AnalyticsLiveOperations": { "type": "object", "additionalProperties": false, "required": [ "queue", "workers" ], "properties": { "queue": { "$ref": "#/components/schemas/AnalyticsDocumentQueueSnapshot" }, "workers": { "$ref": "#/components/schemas/AnalyticsDocumentWorkerSnapshot" } } }, "AnalyticsDecisionSummary": { "type": "object", "description": "One repeatable-read snapshot of adjacent equal submission cohorts. Queue and worker evidence is live and retains independent observation timestamps.", "additionalProperties": false, "required": [ "observed_at", "current", "previous", "comparisons", "error_group_count", "error_groups_truncated", "error_groups", "percentile_method", "live_operations" ], "properties": { "observed_at": { "type": "string", "format": "date-time", "description": "UTC time at which the repeatable-read decision projection was observed." }, "current": { "$ref": "#/components/schemas/AnalyticsDecisionPeriod" }, "previous": { "$ref": "#/components/schemas/AnalyticsDecisionPeriod" }, "comparisons": { "$ref": "#/components/schemas/AnalyticsDecisionComparisons" }, "error_group_count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "Exact distinct scope/code group count before the bounded response window." }, "error_groups_truncated": { "type": "boolean", "description": "True exactly when error_group_count exceeds the returned error_groups length." }, "error_groups": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/components/schemas/AnalyticsComparedErrorGroup" } }, "percentile_method": { "type": "string", "const": "nearest_rank" }, "live_operations": { "$ref": "#/components/schemas/AnalyticsLiveOperations" } } }, "AnalyticsContributor": { "type": "object", "additionalProperties": false, "required": [ "kind", "submission_id", "submission_path" ], "properties": { "kind": { "type": "string", "enum": [ "ingestion_submission", "processing_node", "blocked_node" ] }, "submission_id": { "type": "string", "format": "uuid" }, "submission_path": { "type": "string", "pattern": "^/api/v1/submissions/[0-9a-f-]{36}$" }, "processing_node_id": { "type": "string", "format": "uuid" }, "processing_node_address": { "type": "string", "minLength": 3, "maxLength": 1024 }, "element_path": { "type": "string", "pattern": "^/api/v1/submissions/[0-9a-f-]{36}/elements/[0-9a-f-]{36}$" }, "execution_id": { "type": "string", "format": "uuid" }, "execution_path": { "type": "string", "pattern": "^/api/v1/executions/[0-9a-f-]{36}$" }, "contribution_duration_ms": { "type": "integer", "minimum": 0 } }, "oneOf": [ { "properties": { "kind": { "const": "ingestion_submission" } }, "not": { "anyOf": [ { "required": [ "processing_node_id" ] }, { "required": [ "processing_node_address" ] }, { "required": [ "element_path" ] }, { "required": [ "execution_id" ] }, { "required": [ "execution_path" ] } ] } }, { "properties": { "kind": { "const": "processing_node" } }, "required": [ "processing_node_id", "processing_node_address", "element_path", "execution_id", "execution_path" ] }, { "properties": { "kind": { "const": "blocked_node" } }, "required": [ "processing_node_id", "processing_node_address", "element_path" ], "not": { "anyOf": [ { "required": [ "execution_id" ] }, { "required": [ "execution_path" ] } ] } } ] }, "AnalyticsProcessingContributorPage": { "type": "object", "additionalProperties": false, "required": [ "observed_at", "bucket", "items", "next_cursor" ], "properties": { "observed_at": { "type": "string", "format": "date-time" }, "bucket": { "$ref": "#/components/schemas/AnalyticsDecisionProcessingLoadBucket" }, "items": { "type": "array", "maxItems": 100, "items": { "allOf": [ { "$ref": "#/components/schemas/AnalyticsContributor" }, { "required": [ "contribution_duration_ms" ], "properties": { "kind": { "enum": [ "ingestion_submission", "processing_node" ] } } } ] } }, "next_cursor": { "type": [ "string", "null" ], "minLength": 45, "maxLength": 512, "pattern": "^[A-Za-z0-9_-]+[.][A-Za-z0-9_-]{43}$" } } }, "AnalyticsFailureContributorPage": { "type": "object", "additionalProperties": false, "required": [ "observed_at", "group", "items", "next_cursor" ], "properties": { "observed_at": { "type": "string", "format": "date-time" }, "group": { "$ref": "#/components/schemas/AnalyticsErrorGroupFact" }, "items": { "type": "array", "maxItems": 100, "items": { "allOf": [ { "$ref": "#/components/schemas/AnalyticsContributor" }, { "not": { "required": [ "contribution_duration_ms" ] } } ] } }, "next_cursor": { "type": [ "string", "null" ], "minLength": 45, "maxLength": 512, "pattern": "^[A-Za-z0-9_-]+[.][A-Za-z0-9_-]{43}$" } } }, "SubmissionMetadata": { "type": "object", "additionalProperties": false, "required": [ "model_slug", "object_reference", "object_effective_at", "source_system", "source_actor" ], "properties": { "model_slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "object_reference": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "object_effective_at": { "type": "string", "format": "date-time" }, "source_system": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "source_actor": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" } } }, "SubmitSubmissionRequest": { "type": "object", "additionalProperties": false, "required": [ "metadata", "payload" ], "properties": { "metadata": { "$ref": "#/components/schemas/SubmissionMetadata" }, "payload": { "x-docula-max-bytes": 524288 } } }, "DefinitionSelection": { "type": "object", "additionalProperties": false, "required": [ "family_id", "activation_id", "version_id", "version", "slug", "content_hash", "effective_from" ], "properties": { "family_id": { "type": "string", "format": "uuid" }, "activation_id": { "type": "string", "format": "uuid" }, "version_id": { "type": "string", "format": "uuid" }, "version": { "type": "integer", "minimum": 1 }, "slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "effective_from": { "type": "string", "format": "date-time" } } }, "ReleaseSelection": { "type": "object", "additionalProperties": false, "required": [ "id", "content_hash" ], "properties": { "id": { "type": "string", "format": "uuid" }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "node_address": { "type": "string", "minLength": 3, "maxLength": 1024, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$" }, "input_mode": { "type": "string", "enum": [ "submission", "parent_output" ] }, "producer_node_address": { "type": "string", "minLength": 3, "maxLength": 1024, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$" }, "producer_release_id": { "type": "string", "format": "uuid" }, "producer_release_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "validation_input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "oneOf": [ { "not": { "anyOf": [ { "required": [ "node_address" ] }, { "required": [ "input_mode" ] }, { "required": [ "producer_node_address" ] }, { "required": [ "producer_release_id" ] }, { "required": [ "producer_release_hash" ] }, { "required": [ "validation_input_hash" ] } ] } }, { "required": [ "node_address", "input_mode", "validation_input_hash" ], "properties": { "input_mode": { "const": "submission" } }, "not": { "anyOf": [ { "required": [ "producer_node_address" ] }, { "required": [ "producer_release_id" ] }, { "required": [ "producer_release_hash" ] } ] } }, { "required": [ "node_address", "input_mode", "producer_node_address", "producer_release_id", "producer_release_hash", "validation_input_hash" ], "properties": { "input_mode": { "const": "parent_output" } } } ] }, "IngestionSelectionNode": { "type": "object", "additionalProperties": false, "required": [ "kind", "name", "slug", "address", "position" ], "properties": { "kind": { "type": "string", "enum": [ "transformation", "document_generation" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "address": { "type": "string", "minLength": 3, "maxLength": 1024 }, "parent_address": { "type": "string", "minLength": 3, "maxLength": 1024 }, "position": { "type": "integer", "minimum": 1, "maximum": 100 }, "transform": { "$ref": "#/components/schemas/DefinitionSelection" }, "template": { "$ref": "#/components/schemas/DefinitionSelection" }, "release": { "$ref": "#/components/schemas/ReleaseSelection" } } }, "SubmissionRecord": { "type": "object", "additionalProperties": false, "required": [ "id", "ingestion_id", "submitted_by", "correlation_id", "metadata", "original_payload_hash", "canonical_payload_hash", "request_hash", "ingestion_status", "processing_triggered", "received_at", "plan" ], "properties": { "id": { "type": "string", "format": "uuid" }, "ingestion_id": { "type": "string", "format": "uuid" }, "submitted_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "metadata": { "$ref": "#/components/schemas/SubmissionMetadata" }, "original_payload_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "canonical_payload_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "ingestion_status": { "type": "string", "enum": [ "received", "accepted", "rejected" ] }, "processing_triggered": { "type": "boolean" }, "reason_code": { "type": "string", "maxLength": 128, "pattern": "^[a-z0-9]+(?:_[a-z0-9]+)*$" }, "model": { "$ref": "#/components/schemas/DefinitionSelection" }, "received_at": { "type": "string", "format": "date-time" }, "ingestion_completed_at": { "type": "string", "format": "date-time" }, "plan": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/SubmissionPlanNode" } }, "selection_snapshot": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/IngestionSelectionNode" } } } }, "SubmissionPlanNode": { "type": "object", "additionalProperties": false, "required": [ "id", "submission_id", "kind", "name", "slug", "address", "position", "transform", "release" ], "properties": { "id": { "type": "string", "format": "uuid" }, "submission_id": { "type": "string", "format": "uuid" }, "parent_node_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "transformation", "document_generation" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "address": { "type": "string", "minLength": 3, "maxLength": 1024 }, "position": { "type": "integer", "minimum": 1, "maximum": 100 }, "transform": { "$ref": "#/components/schemas/DefinitionSelection" }, "template": { "$ref": "#/components/schemas/DefinitionSelection" }, "release": { "$ref": "#/components/schemas/ReleaseSelection" } }, "allOf": [ { "if": { "properties": { "kind": { "const": "document_generation" } }, "required": [ "kind" ] }, "then": { "required": [ "template" ] } }, { "if": { "properties": { "kind": { "const": "transformation" } }, "required": [ "kind" ] }, "then": { "not": { "required": [ "template" ] } } } ] }, "SubmissionMutation": { "type": "object", "additionalProperties": false, "required": [ "submission", "correlation_id", "result_url", "idempotent_replay" ], "properties": { "submission": { "$ref": "#/components/schemas/SubmissionRecord" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "result_url": { "type": "string", "pattern": "^/api/v1/submissions/[0-9a-f-]{36}$" }, "idempotent_replay": { "type": "boolean" } } }, "SubmissionListItem": { "type": "object", "additionalProperties": false, "required": [ "id", "model_slug", "object_reference", "object_effective_at", "received_at", "ingestion_outcome", "processing_triggered", "processing_outcome", "storage_object_count", "storage_bytes" ], "properties": { "id": { "type": "string", "format": "uuid" }, "model_slug": { "type": "string", "minLength": 1, "maxLength": 64 }, "object_reference": { "type": "string", "minLength": 1, "maxLength": 128 }, "object_effective_at": { "type": "string", "format": "date-time" }, "received_at": { "type": "string", "format": "date-time" }, "ingestion_outcome": { "type": "string", "enum": [ "received", "accepted", "rejected" ] }, "processing_triggered": { "type": "boolean" }, "processing_outcome": { "$ref": "#/components/schemas/SubmissionListProcessingOutcome" }, "reason_code": { "type": "string", "maxLength": 128 }, "storage_object_count": { "type": "integer", "minimum": 0 }, "storage_bytes": { "type": "integer", "minimum": 0 } } }, "SubmissionList": { "type": "object", "additionalProperties": false, "required": [ "submissions" ], "properties": { "submissions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/SubmissionListItem" } }, "next_cursor": { "type": "string", "minLength": 1, "maxLength": 512 } } }, "SubmissionListProcessingOutcome": { "type": "string", "enum": [ "not_triggered", "pending", "queued", "processing", "completed", "failed", "partial_failure" ] }, "ProcessingOutcome": { "type": "string", "enum": [ "not_triggered", "pending", "queued", "processing", "completed", "failed", "blocked", "partial_failure" ] }, "ProcessingNodeStatus": { "type": "string", "enum": [ "pending", "queued", "processing", "awaiting_compose", "completed", "failed", "blocked" ] }, "TransformationListItem": { "type": "object", "additionalProperties": false, "required": [ "id", "submission_id", "object_reference", "model_slug", "name", "slug", "address", "status", "attempt_count", "created_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "submission_id": { "type": "string", "format": "uuid" }, "object_reference": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "model_slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "address": { "type": "string", "minLength": 3, "maxLength": 1024, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$" }, "status": { "$ref": "#/components/schemas/ProcessingNodeStatus" }, "attempt_count": { "type": "integer", "minimum": 0, "maximum": 5 }, "duration_ms": { "type": "integer", "minimum": 0 }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "updated_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } }, "allOf": [ { "if": { "properties": { "status": { "enum": [ "completed", "failed" ] } }, "required": [ "status" ] }, "then": { "required": [ "duration_ms" ] } }, { "if": { "properties": { "status": { "enum": [ "pending", "queued", "processing", "awaiting_compose", "blocked" ] } }, "required": [ "status" ] }, "then": { "not": { "required": [ "duration_ms" ] } } } ] }, "TransformationPage": { "type": "object", "additionalProperties": false, "required": [ "transformations" ], "properties": { "transformations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/TransformationListItem" } }, "next_cursor": { "type": "string", "minLength": 1, "maxLength": 512 } } }, "ContentDescriptor": { "type": "object", "additionalProperties": false, "required": [ "available" ], "properties": { "available": { "type": "boolean" }, "media_type": { "type": "string", "enum": [ "application/json", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/pdf" ] }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 26214400 }, "hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "href": { "type": "string", "oneOf": [ { "pattern": "^/api/v1/submissions/[0-9a-f-]{36}/elements/[0-9a-f-]{36}/content$" }, { "pattern": "^/api/v1/executions/[0-9a-f-]{36}/artifacts/[0-9a-f-]{36}/download$" } ] } } }, "SubmissionView": { "type": "object", "additionalProperties": false, "required": [ "id", "metadata", "received_at", "submitted_by", "correlation_id", "original_evidence" ], "properties": { "id": { "type": "string", "format": "uuid" }, "metadata": { "$ref": "#/components/schemas/SubmissionMetadata" }, "received_at": { "type": "string", "format": "date-time" }, "submitted_by": { "type": "string", "format": "uuid" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "original_evidence": { "$ref": "#/components/schemas/ContentDescriptor" } } }, "SubmissionFailure": { "type": "object", "additionalProperties": false, "required": [ "code" ], "properties": { "code": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,63}$" }, "detail": { "type": "string", "minLength": 1, "maxLength": 240 }, "blocked_by": { "type": "string", "format": "uuid" }, "root_cause_code": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,63}$" } } }, "IngestionView": { "type": "object", "additionalProperties": false, "required": [ "id", "outcome", "processing_triggered", "selection_snapshot" ], "properties": { "id": { "type": "string", "format": "uuid" }, "outcome": { "type": "string", "enum": [ "received", "accepted", "rejected" ] }, "processing_triggered": { "type": "boolean" }, "reason_code": { "type": "string", "maxLength": 128 }, "decision_as_of": { "type": "string", "format": "date-time" }, "completed_at": { "type": "string", "format": "date-time" }, "model": { "$ref": "#/components/schemas/DefinitionSelection" }, "selection_snapshot": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/IngestionSelectionNode" } } } }, "ProcessingElement": { "type": "object", "additionalProperties": false, "required": [ "id", "submission_id", "kind", "name", "slug", "address", "position", "transform", "release", "status", "attempt_count", "peak_rss_bytes", "peak_rss_availability", "content" ], "properties": { "id": { "type": "string", "format": "uuid" }, "submission_id": { "type": "string", "format": "uuid" }, "parent_node_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "transformation", "document_generation" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "address": { "type": "string", "minLength": 3, "maxLength": 1024 }, "position": { "type": "integer", "minimum": 1, "maximum": 100 }, "transform": { "$ref": "#/components/schemas/DefinitionSelection" }, "template": { "$ref": "#/components/schemas/DefinitionSelection" }, "release": { "$ref": "#/components/schemas/ReleaseSelection" }, "status": { "$ref": "#/components/schemas/ProcessingNodeStatus" }, "execution_id": { "type": "string", "format": "uuid" }, "attempt_count": { "type": "integer", "minimum": 0, "maximum": 5 }, "submitted_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "completed_at": { "type": "string", "format": "date-time" }, "duration_ms": { "type": "integer", "minimum": 0, "description": "Elapsed time from the canonical execution timestamps; present only for completed or failed executions." }, "peak_rss_bytes": { "type": [ "integer", "null" ], "minimum": 0, "description": "Maximum honestly attributable peak RSS across all execution step attempts; null when any required measurement is unavailable." }, "peak_rss_availability": { "type": "string", "enum": [ "measured", "unavailable" ] }, "failure": { "$ref": "#/components/schemas/SubmissionFailure" }, "content": { "$ref": "#/components/schemas/ContentDescriptor" } }, "allOf": [ { "if": { "properties": { "kind": { "const": "document_generation" } }, "required": [ "kind" ] }, "then": { "required": [ "template" ] } }, { "if": { "properties": { "kind": { "const": "transformation" } }, "required": [ "kind" ] }, "then": { "not": { "required": [ "template" ] } } }, { "if": { "properties": { "status": { "enum": [ "completed", "failed" ] } }, "required": [ "status" ] }, "then": { "required": [ "duration_ms" ] } } ] }, "StorageListItem": { "type": "object", "additionalProperties": false, "required": [ "artifact_id", "submission_id", "object_reference", "model_slug", "producing_node_label", "producing_node_address", "format", "media_type", "byte_size", "content_hash", "created_at", "download_path" ], "properties": { "artifact_id": { "type": "string", "format": "uuid" }, "submission_id": { "type": "string", "format": "uuid" }, "object_reference": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$" }, "model_slug": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "producing_node_label": { "type": "string", "minLength": 1, "maxLength": 160 }, "producing_node_address": { "type": "string", "minLength": 3, "maxLength": 1024, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$" }, "format": { "type": "string", "enum": [ "docx", "pdf" ] }, "media_type": { "type": "string", "enum": [ "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/pdf" ] }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 26214400 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "download_path": { "type": "string", "pattern": "^/api/v1/executions/[0-9a-f-]{36}/artifacts/[0-9a-f-]{36}/download$" } } }, "StoragePage": { "type": "object", "additionalProperties": false, "required": [ "storage" ], "properties": { "storage": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/StorageListItem" } }, "next_cursor": { "type": "string", "minLength": 1, "maxLength": 512 } } }, "ConfigurationDeploymentSummary": { "type": "object", "additionalProperties": false, "required": [ "id", "status", "item_count", "manifest_hash", "correlation_id", "created_at", "applied_at" ], "properties": { "id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "status": { "const": "applied" }, "item_count": { "type": "integer", "minimum": 1, "maximum": 100 }, "manifest_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "applied_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationDeploymentList": { "type": "object", "additionalProperties": false, "required": [ "deployments", "correlation_id" ], "properties": { "deployments": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationDeploymentSummary" } }, "next_cursor": { "type": "string", "minLength": 1, "maxLength": 512 }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" } } }, "ConfigurationProvenanceOriginDeployment": { "type": "object", "additionalProperties": false, "required": [ "id", "status", "applied_at", "correlation_id" ], "properties": { "id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "status": { "const": "applied" }, "applied_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9._:-]+$" } } }, "ConfigurationProvenanceOriginOutcome": { "type": "object", "additionalProperties": false, "required": [ "position", "local_ref", "resource_kind", "operation", "outcome", "resource_id", "content_hash", "created_at" ], "properties": { "position": { "type": "integer", "minimum": 1, "maximum": 100 }, "local_ref": { "$ref": "#/components/schemas/ConfigurationDeploymentLocalRef" }, "resource_kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template", "release" ] }, "operation": { "type": "string", "enum": [ "deploy", "publish" ] }, "outcome": { "type": "string", "enum": [ "created", "scheduled" ] }, "resource_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "family_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "version_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "activation_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "release_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "slug": { "$ref": "#/components/schemas/ConfigurationDeploymentSlug" }, "revision": { "type": "integer", "minimum": 1 }, "content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "published_at": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "created_at": { "$ref": "#/components/schemas/CanonicalTimestamp" } } }, "ConfigurationProvenanceEntry": { "type": "object", "additionalProperties": false, "required": [ "component_kind", "node_address", "resource_id", "content_hash", "deployment_available" ], "properties": { "component_kind": { "type": "string", "enum": [ "ingestion_model", "transformer", "template", "release" ] }, "node_address": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){0,15}$" }, "resource_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "family_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "activation_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "version_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "release_id": { "$ref": "#/components/schemas/ConfigurationDeploymentUUID" }, "slug": { "$ref": "#/components/schemas/ConfigurationDeploymentSlug" }, "content_hash": { "$ref": "#/components/schemas/ConfigurationDeploymentHash" }, "effective_from": { "$ref": "#/components/schemas/CanonicalTimestamp" }, "deployment_available": { "type": "boolean" }, "origin_deployment": { "$ref": "#/components/schemas/ConfigurationProvenanceOriginDeployment" }, "origin_outcome": { "$ref": "#/components/schemas/ConfigurationProvenanceOriginOutcome" } }, "allOf": [ { "if": { "properties": { "deployment_available": { "const": true } }, "required": [ "deployment_available" ] }, "then": { "required": [ "origin_deployment", "origin_outcome" ] } }, { "if": { "properties": { "deployment_available": { "const": false } }, "required": [ "deployment_available" ] }, "then": { "not": { "anyOf": [ { "required": [ "origin_deployment" ] }, { "required": [ "origin_outcome" ] } ] } } } ] }, "StorageElement": { "type": "object", "additionalProperties": false, "required": [ "id", "producing_node_id", "execution_id", "format", "media_type", "byte_size", "content_hash", "created_at", "download_path" ], "properties": { "id": { "type": "string", "format": "uuid" }, "producing_node_id": { "type": "string", "format": "uuid" }, "execution_id": { "type": "string", "format": "uuid" }, "format": { "type": "string", "enum": [ "docx", "pdf" ] }, "media_type": { "type": "string", "enum": [ "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/pdf" ] }, "byte_size": { "type": "integer", "minimum": 1, "maximum": 26214400 }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "created_at": { "type": "string", "format": "date-time" }, "download_path": { "type": "string", "pattern": "^/api/v1/executions/[0-9a-f-]{36}/artifacts/[0-9a-f-]{36}/download$" } } }, "SubmissionGraph": { "type": "object", "additionalProperties": false, "x-docula-max-elements": 100, "x-docula-max-edges": 100, "required": [ "submission", "ingestion", "processing_outcome", "processing", "storage", "configuration_provenance" ], "properties": { "submission": { "$ref": "#/components/schemas/SubmissionView" }, "ingestion": { "$ref": "#/components/schemas/IngestionView" }, "processing_outcome": { "$ref": "#/components/schemas/ProcessingOutcome" }, "processing": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ProcessingElement" } }, "storage": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/StorageElement" } }, "configuration_provenance": { "type": "array", "maxItems": 301, "items": { "$ref": "#/components/schemas/ConfigurationProvenanceEntry" } } } }, "SubmissionElement": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "content" ], "properties": { "id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "submission", "ingestion", "transformation", "document_generation", "storage" ] }, "submission": { "$ref": "#/components/schemas/SubmissionView" }, "ingestion": { "$ref": "#/components/schemas/IngestionView" }, "processing": { "$ref": "#/components/schemas/ProcessingElement" }, "storage": { "$ref": "#/components/schemas/StorageElement" }, "content": { "$ref": "#/components/schemas/ContentDescriptor" } } }, "RCADemoUIFacts": { "type": "object", "additionalProperties": false, "required": [ "outcome_label", "schedule_label", "journey_summary", "expected_transformations", "expected_documents", "blocked_nodes" ], "properties": { "outcome_label": { "type": "string", "minLength": 1, "maxLength": 160 }, "schedule_label": { "type": "string", "minLength": 1, "maxLength": 160 }, "journey_summary": { "type": "string", "minLength": 1, "maxLength": 512 }, "expected_transformations": { "type": "integer", "minimum": 0, "maximum": 4 }, "expected_documents": { "type": "integer", "minimum": 0, "maximum": 5 }, "failed_node": { "type": "string", "const": "date-persoana" }, "blocked_nodes": { "type": "array", "maxItems": 2, "uniqueItems": true, "items": { "type": "string", "enum": [ "gdpr", "fisa-t-plus-1" ] } } } }, "RCADemoScenario": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "description", "expected_ingestion", "expected_person_branch", "schedule_interval_months", "metadata", "source_payload", "source_payload_media_type", "source_payload_bytes", "source_payload_sha256", "ui_facts" ], "properties": { "id": { "type": "string", "enum": [ "1-month", "6-month", "12-month", "ingestion-rejection", "person-branch-failure" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 160 }, "description": { "type": "string", "minLength": 1, "maxLength": 512 }, "expected_ingestion": { "type": "string", "enum": [ "accepted", "rejected" ] }, "expected_person_branch": { "type": "string", "enum": [ "succeeded", "not_started", "failed" ] }, "schedule_interval_months": { "type": "integer", "enum": [ 1, 6, 12 ] }, "metadata": { "$ref": "#/components/schemas/SubmissionMetadata" }, "source_payload": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 }, "source_payload_media_type": { "type": "string", "const": "application/json" }, "source_payload_bytes": { "type": "integer", "minimum": 1, "maximum": 524288 }, "source_payload_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "ui_facts": { "$ref": "#/components/schemas/RCADemoUIFacts" } } }, "RCADemoCatalog": { "type": "object", "additionalProperties": false, "required": [ "fixture_family", "scenarios" ], "properties": { "fixture_family": { "type": "string", "const": "polita-rca-v1" }, "scenarios": { "type": "array", "minItems": 5, "maxItems": 5, "items": { "$ref": "#/components/schemas/RCADemoScenario" } } } }, "DemoScenario": { "type": "object", "additionalProperties": false, "required": [ "id", "name", "description", "expected_outcome", "schedule_interval_months", "raw_input", "raw_input_hash", "metadata" ], "properties": { "id": { "type": "string", "enum": [ "monthly", "semiannual", "annual", "invalid" ] }, "name": { "type": "string" }, "description": { "type": "string" }, "expected_outcome": { "type": "string" }, "schedule_interval_months": { "type": "integer", "enum": [ 1, 6, 12 ] }, "raw_input": { "type": "string", "minLength": 1, "x-docula-max-bytes": 524288 }, "raw_input_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "metadata": { "$ref": "#/components/schemas/IntakeMetadata" } } }, "DemoCatalog": { "type": "object", "additionalProperties": false, "required": [ "fixture_family", "ready", "scenarios" ], "properties": { "fixture_family": { "type": "string", "const": "clws-policy-v1" }, "release_id": { "type": "string", "format": "uuid" }, "ready": { "type": "boolean" }, "scenarios": { "type": "array", "minItems": 4, "maxItems": 4, "items": { "$ref": "#/components/schemas/DemoScenario" } } } }, "DemoHistory": { "type": "object", "additionalProperties": false, "required": [ "executions" ], "properties": { "executions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/Execution" } } } }, "DemoStageDuration": { "type": "object", "additionalProperties": false, "required": [ "name", "sample_count" ], "properties": { "name": { "type": "string", "enum": [ "validate", "transform.declarative", "compose", "render" ] }, "sample_count": { "type": "integer", "minimum": 1 }, "average_duration_ms": { "type": "integer", "minimum": 0 }, "p50_duration_ms": { "type": "integer", "minimum": 0 }, "p95_duration_ms": { "type": "integer", "minimum": 0 } } }, "DemoStatistics": { "type": "object", "additionalProperties": false, "required": [ "fixture_family", "intake_count", "terminal_count", "succeeded_count", "failed_count", "raw_bytes", "generated_document_count", "docx_count", "pdf_count", "stage_durations", "observation_window_ms", "percentile_method" ], "properties": { "fixture_family": { "type": "string", "const": "clws-policy-v1" }, "intake_count": { "type": "integer", "minimum": 0 }, "terminal_count": { "type": "integer", "minimum": 0 }, "succeeded_count": { "type": "integer", "minimum": 0 }, "failed_count": { "type": "integer", "minimum": 0 }, "raw_bytes": { "type": "integer", "minimum": 0 }, "generated_document_count": { "type": "integer", "minimum": 0 }, "docx_count": { "type": "integer", "minimum": 0 }, "pdf_count": { "type": "integer", "minimum": 0 }, "success_rate": { "type": "number", "minimum": 0, "maximum": 1 }, "average_duration_ms": { "type": "integer", "minimum": 0 }, "p50_duration_ms": { "type": "integer", "minimum": 0 }, "p95_duration_ms": { "type": "integer", "minimum": 0 }, "stage_durations": { "type": "array", "maxItems": 4, "items": { "$ref": "#/components/schemas/DemoStageDuration" } }, "throughput_per_minute": { "type": "number", "minimum": 0 }, "first_submitted_at": { "type": "string", "format": "date-time" }, "last_terminal_at": { "type": "string", "format": "date-time" }, "observation_window_ms": { "type": "integer", "minimum": 0 }, "percentile_method": { "type": "string", "const": "nearest-rank" } } }, "ExecutionEvent": { "type": "object", "additionalProperties": false, "required": [ "id", "execution_id", "type", "correlation_id", "payload", "occurred_at" ], "properties": { "id": { "type": "integer", "format": "int64", "minimum": 1 }, "execution_id": { "type": "string", "format": "uuid" }, "type": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,99}$" }, "step": { "type": "string", "enum": [ "validate", "transform.declarative", "compose", "render" ] }, "attempt": { "type": "integer", "minimum": 1, "maximum": 5 }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "payload": { "type": "object" }, "occurred_at": { "type": "string", "format": "date-time" } } }, "SubmissionEvent": { "type": "object", "additionalProperties": false, "required": [ "sequence", "submission_id", "occurred_at", "phase", "event", "status", "lineage_node_id" ], "properties": { "sequence": { "type": "integer", "format": "int64", "minimum": 1, "description": "Stable persisted cursor, allocated contiguously and independently for this submission." }, "submission_id": { "type": "string", "format": "uuid" }, "occurred_at": { "type": "string", "format": "date-time" }, "phase": { "type": "string", "enum": [ "submission", "ingestion", "transformation", "document_generation", "storage" ] }, "event": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,99}$" }, "status": { "type": "string", "enum": [ "received", "accepted", "rejected", "not_triggered", "pending", "queued", "processing", "awaiting_compose", "running", "succeeded", "retry_scheduled", "failed", "blocked", "completed", "partial_failure", "recorded", "stored" ] }, "lineage_node_id": { "type": "string", "format": "uuid" }, "parent_lineage_node_id": { "type": "string", "format": "uuid" }, "attempt": { "type": "integer", "minimum": 1, "maximum": 5 }, "duration_ms": { "type": "integer", "minimum": 0 }, "error": { "$ref": "#/components/schemas/SubmissionEventError" } } }, "SubmissionEventError": { "type": "object", "additionalProperties": false, "required": [ "code" ], "properties": { "code": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,63}$" }, "root_cause_code": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]{0,63}$" } } }, "AuditEvent": { "type": "object", "additionalProperties": false, "required": [ "id", "occurred_at", "actor_kind", "action", "correlation_id", "outcome", "metadata" ], "properties": { "id": { "type": "string", "format": "uuid" }, "occurred_at": { "type": "string", "format": "date-time" }, "actor_kind": { "type": "string", "enum": [ "system", "user" ] }, "actor_user_id": { "type": "string", "format": "uuid" }, "actor_username": { "type": "string" }, "action": { "type": "string", "minLength": 1, "maxLength": 100 }, "object_type": { "type": "string" }, "object_id": { "type": "string" }, "object_version": { "type": "string" }, "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 }, "outcome": { "type": "string", "enum": [ "success", "failure", "denied" ] }, "metadata": { "type": "object" } } }, "AuditList": { "type": "object", "additionalProperties": false, "required": [ "events" ], "properties": { "events": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/AuditEvent" } }, "next_cursor": { "type": "string", "format": "uuid" } } }, "MutationProblem": { "type": "object", "additionalProperties": false, "required": [ "type", "title", "status", "code", "detail", "correlation_id" ], "properties": { "type": { "type": "string", "pattern": "^/problems/[a-z_]+$" }, "title": { "type": "string", "minLength": 1 }, "status": { "type": "integer", "const": 403 }, "code": { "type": "string", "enum": [ "csrf_rejected", "forbidden" ] }, "detail": { "type": "string", "minLength": 1 }, "correlation_id": { "type": "string", "minLength": 1 } } }, "ValidationProblem": { "type": "object", "additionalProperties": false, "required": [ "type", "title", "status", "code", "detail", "correlation_id" ], "properties": { "type": { "type": "string", "const": "/problems/validation_failed" }, "title": { "type": "string", "minLength": 1 }, "status": { "type": "integer", "const": 422 }, "code": { "type": "string", "const": "validation_failed" }, "detail": { "type": "string", "minLength": 1 }, "correlation_id": { "type": "string", "minLength": 1 }, "errors": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "$ref": "#/components/schemas/ProblemError" } } } }, "ProblemError": { "type": "object", "additionalProperties": false, "required": ["path", "rule", "detail"], "properties": { "path": {"type": "string", "minLength": 1}, "rule": {"type": "string", "minLength": 1}, "detail": {"type": "string", "minLength": 1}, "value": { "description": "Offending submitted value. Present only in development; omitted in test and production.", "nullable": true } } }, "SchemaValidationError": { "type": "object", "additionalProperties": false, "required": [ "path", "message" ], "properties": { "path": { "type": "string", "minLength": 1 }, "message": { "type": "string", "minLength": 1 }, "line": { "type": "integer", "minimum": 1 }, "column": { "type": "integer", "minimum": 1 } } }, "SchemaValidation": { "type": "object", "additionalProperties": false, "required": [ "valid", "errors" ], "properties": { "valid": { "type": "boolean" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/SchemaValidationError" } } } }, "Problem": { "type": "object", "additionalProperties": false, "required": [ "type", "title", "status", "code", "detail", "correlation_id" ], "properties": { "type": { "type": "string", "pattern": "^/problems/[a-z_]+$" }, "title": { "type": "string", "minLength": 1 }, "status": { "type": "integer", "minimum": 400, "maximum": 599 }, "code": { "type": "string", "enum": [ "internal_error", "dependency_unavailable", "invalid_credentials", "origin_rejected", "validation_failed", "rate_limited", "authentication_required", "csrf_rejected", "forbidden", "conflict", "not_found", "method_not_allowed", "unsupported_media_type", "content_unavailable", "precondition_required", "precondition_failed" ] }, "detail": { "type": "string", "minLength": 1 }, "correlation_id": { "type": "string", "minLength": 1 }, "dependencies": { "type": "array", "maxItems": 3, "items": { "$ref": "#/components/schemas/PublicDependency" } } } } }, "responses": { "IngestionModelListOK": { "description": "At most 100 canonical ingestion-model summaries.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "ingestion_models" ], "properties": { "ingestion_models": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/CanonicalDefinitionSummary" } } } }, "examples": { "synthetic": { "summary": "Synthetic IngestionModelListOK response", "value": { "ingestion_models": [ { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 0, "updated_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "Cel mult 100 de rezumate ale modelelor canonice de ingestie." }, "IngestionModelOK": { "description": "One canonical ingestion-model family without source definitions.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestionModelFamily" }, "examples": { "synthetic": { "summary": "Synthetic IngestionModelOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "number": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "source_revision": 1, "status": "versioned", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "language": "declarative-v1" } ] } } } } }, "x-docula-description-ro": "O familie canonică de modele de ingestie, fără definițiile sursă." }, "IngestionModelDraftOK": { "description": "The current revisioned ingestion-model draft.", "headers": { "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"[1-9][0-9]*\"$" }, "description": "Current strong decimal draft revision ETag returned for a subsequent If-Match precondition.", "x-docula-description-ro": "ETagul puternic al reviziei zecimale curente, returnat pentru o precondiție If-Match ulterioară." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestionModelDraft" }, "examples": { "synthetic": { "summary": "Synthetic IngestionModelDraftOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "definition": {}, "revision": 1, "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "updated_at": "2026-08-01T10:00:00Z" } } } } }, "x-docula-description-ro": "Ciorna curentă revizionată a modelului de ingestie." }, "IngestionModelVersionsOK": { "description": "At most 100 immutable ingestion-model versions.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "versions" ], "properties": { "versions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/CanonicalDefinitionVersion" } } } }, "examples": { "synthetic": { "summary": "Synthetic IngestionModelVersionsOK response", "value": { "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "number": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "source_revision": 1, "status": "versioned", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "language": "declarative-v1" } ] } } } } }, "x-docula-description-ro": "Cel mult 100 de versiuni imuabile ale modelului de ingestie." }, "IngestionModelValidationOK": { "description": "Bounded deterministic ingestion-model validation; invalid input is represented by ordered errors.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationValidationResult" }, "examples": { "synthetic": { "summary": "Synthetic IngestionModelValidationOK response", "value": { "valid": false, "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ], "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Validare deterministă mărginită a modelului de ingestie; intrarea invalidă este reprezentată prin erori ordonate." }, "CanonicalTransformerListOK": { "description": "At most 100 canonical transformer summaries and explicit truncation truth.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transformers", "next_cursor", "truncated" ], "properties": { "transformers": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/CanonicalDefinitionSummary" } }, "next_cursor": { "type": [ "string", "null" ], "minLength": 1, "maxLength": 256, "description": "Opaque cursor for the next stable page, or null when this is the final page." }, "truncated": { "type": "boolean" } } }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTransformerListOK response", "value": { "transformers": [ { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 0, "updated_at": "2026-08-01T10:00:00Z" } ], "next_cursor": null, "truncated": false } } } } }, "x-docula-description-ro": "Cel mult 100 de rezumate ale transformatoarelor canonice și starea explicită a trunchierii." }, "CanonicalTransformerOK": { "description": "One canonical transformer family.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTransformerDetail" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTransformerOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z" } } } } }, "x-docula-description-ro": "O familie canonică de transformatoare." }, "CanonicalTransformerDraftOK": { "description": "The current revisioned canonical transformer draft.", "headers": { "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"[1-9][0-9]*\"$" }, "description": "Current strong decimal draft revision ETag returned for a subsequent If-Match precondition.", "x-docula-description-ro": "ETagul puternic al reviziei zecimale curente, returnat pentru o precondiție If-Match ulterioară." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTransformerDraft" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTransformerDraftOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "source": "synthetic-example", "format": "yaml", "revision": 1, "updated_at": "2026-08-01T10:00:00Z" } } } } }, "x-docula-description-ro": "Ciorna curentă revizionată a transformatorului canonic." }, "CanonicalTransformerVersionsOK": { "description": "At most 100 immutable transformer versions and explicit truncation truth.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "versions", "truncated" ], "properties": { "versions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/CanonicalDefinitionVersion" } }, "truncated": { "type": "boolean" } } }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTransformerVersionsOK response", "value": { "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "number": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "source_revision": 1, "status": "versioned", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "language": "declarative-v1" } ], "truncated": false } } } } }, "x-docula-description-ro": "Cel mult 100 de versiuni imuabile ale transformatorului și starea explicită a trunchierii." }, "ConfigurationValidationOK": { "description": "Bounded deterministic side-effect-free validation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationValidationResult" }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationValidationOK response", "value": { "valid": false, "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ], "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Validare deterministă mărginită, fără efecte secundare." }, "ConfigurationDeploymentValidationOK": { "description": "Deterministic side-effect-free validation with at most 100 ordered outcomes and 100 safe issues.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationDeploymentValidation" }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationDeploymentValidationOK response", "value": { "schema": "docula-configuration-deployment-v1", "manifest_hash": "0000000000000000000000000000000000000000000000000000000000000000", "valid": false, "items": [ { "position": 1, "local_ref": "synthetic-example", "resource_kind": "ingestion_model", "operation": "deploy", "outcome": "validated", "dependencies": [ "synthetic-example" ] } ], "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ], "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Validare deterministă fără efecte secundare, cu cel mult 100 de rezultate ordonate și 100 de probleme sigure." }, "ConfigurationDeploymentListOK": { "description": "A bounded newest-first page of redacted configuration deployment summaries with request correlation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationDeploymentList" }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationDeploymentListOK response", "value": { "deployments": [ { "id": "11111111-1111-4111-8111-000000000001", "status": "applied", "item_count": 1, "manifest_hash": "0000000000000000000000000000000000000000000000000000000000000000", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "applied_at": "2026-08-01T10:00:00Z" } ], "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "O pagină mărginită, ordonată de la cel mai nou, cu rezumate redactate ale deploymenturilor de configurare și corelarea cererii." }, "ConfigurationDeploymentOK": { "description": "Immutable canonical manifest and at most 100 ordered committed outcomes with request correlation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationDeploymentRead" }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationDeploymentOK response", "value": { "deployment": { "id": "11111111-1111-4111-8111-000000000001", "schema": "docula-configuration-deployment-v1", "created_by": "11111111-1111-4111-8111-000000000001", "request_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": { "schema": "docula-configuration-deployment-v1", "items": [ { "local_ref": "synthetic-example", "kind": "ingestion_model", "operation": "deploy", "family": { "slug": "synthetic-example", "name": "synthetic-example" }, "definition": { "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "definition": "synthetic-example" }, "effective_from": "2026-08-01T10:00:00Z" } ] }, "status": "applied", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "applied_at": "2026-08-01T10:00:00Z", "items": [ { "position": 1, "local_ref": "synthetic-example", "resource_kind": "ingestion_model", "operation": "deploy", "outcome": "created", "resource_id": "11111111-1111-4111-8111-000000000001", "family_id": "11111111-1111-4111-8111-000000000001", "version_id": "11111111-1111-4111-8111-000000000001", "activation_id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "revision": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z", "created_at": "2026-08-01T10:00:00Z", "dependencies": [], "details": {} } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Manifest canonic imuabil și cel mult 100 de rezultate confirmate ordonate, cu corelarea cererii." }, "ConfigurationDeploymentApplied": { "description": "The complete manifest, module state, audit evidence, deployment record, and replay receipt committed atomically.", "headers": { "Location": { "required": true, "description": "Canonical resource path for the created or replayed result.", "schema": { "type": "string", "pattern": "^/api/v1/configuration-deployments/[0-9a-f-]{36}$" }, "x-docula-description-ro": "Calea canonică a resursei pentru rezultatul creat sau reluat." } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationDeploymentMutationResult" }, { "type": "object", "properties": { "idempotent_replay": { "const": false } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationDeploymentApplied response", "value": { "resource_kind": "configuration_deployment", "resource_id": "11111111-1111-4111-8111-000000000001", "result": { "id": "11111111-1111-4111-8111-000000000001", "schema": "docula-configuration-deployment-v1", "created_by": "11111111-1111-4111-8111-000000000001", "request_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": { "schema": "docula-configuration-deployment-v1", "items": [ { "local_ref": "synthetic-example", "kind": "ingestion_model", "operation": "deploy", "family": { "slug": "synthetic-example", "name": "synthetic-example" }, "definition": { "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "definition": "synthetic-example" }, "effective_from": "2026-08-01T10:00:00Z" } ] }, "status": "applied", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "applied_at": "2026-08-01T10:00:00Z", "items": [ { "position": 1, "local_ref": "synthetic-example", "resource_kind": "ingestion_model", "operation": "deploy", "outcome": "created", "resource_id": "11111111-1111-4111-8111-000000000001", "family_id": "11111111-1111-4111-8111-000000000001", "version_id": "11111111-1111-4111-8111-000000000001", "activation_id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "revision": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z", "created_at": "2026-08-01T10:00:00Z", "dependencies": [], "details": {} } ] }, "response_hash": "0000000000000000000000000000000000000000000000000000000000000000", "idempotent_replay": false, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Manifestul complet, starea modulelor, dovada de audit, înregistrarea deploymentului și confirmarea reluării au fost confirmate atomic." }, "ConfigurationDeploymentReplay": { "description": "The exact actor-scoped key and canonical manifest replayed the stored immutable deployment without new work.", "headers": { "Location": { "required": true, "description": "Canonical resource path for the created or replayed result.", "schema": { "type": "string", "pattern": "^/api/v1/configuration-deployments/[0-9a-f-]{36}$" }, "x-docula-description-ro": "Calea canonică a resursei pentru rezultatul creat sau reluat." }, "Idempotent-Replay": { "required": true, "description": "True when the response replays an earlier exact actor-scoped request without new work.", "schema": { "type": "string", "const": "true" }, "x-docula-description-ro": "True când răspunsul reia o cerere exactă anterioară, limitată la actor, fără procesare nouă." } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationDeploymentMutationResult" }, { "type": "object", "properties": { "idempotent_replay": { "const": true } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationDeploymentReplay response", "value": { "resource_kind": "configuration_deployment", "resource_id": "11111111-1111-4111-8111-000000000001", "result": { "id": "11111111-1111-4111-8111-000000000001", "schema": "docula-configuration-deployment-v1", "created_by": "11111111-1111-4111-8111-000000000001", "request_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": { "schema": "docula-configuration-deployment-v1", "items": [ { "local_ref": "synthetic-example", "kind": "ingestion_model", "operation": "deploy", "family": { "slug": "synthetic-example", "name": "synthetic-example" }, "definition": { "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "definition": "synthetic-example" }, "effective_from": "2026-08-01T10:00:00Z" } ] }, "status": "applied", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "applied_at": "2026-08-01T10:00:00Z", "items": [ { "position": 1, "local_ref": "synthetic-example", "resource_kind": "ingestion_model", "operation": "deploy", "outcome": "created", "resource_id": "11111111-1111-4111-8111-000000000001", "family_id": "11111111-1111-4111-8111-000000000001", "version_id": "11111111-1111-4111-8111-000000000001", "activation_id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "revision": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z", "created_at": "2026-08-01T10:00:00Z", "dependencies": [], "details": {} } ] }, "response_hash": "0000000000000000000000000000000000000000000000000000000000000000", "idempotent_replay": true, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Cheia exactă limitată la actor și manifestul canonic au reluat deploymentul imuabil stocat fără procesare nouă." }, "CanonicalTransformerTestOK": { "description": "Deterministic canonical output, hashes, trace, and bounded safe issues.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTransformerTestResult" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTransformerTestOK response", "value": { "valid": false, "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ], "trace": { "entries": [ { "path": "synthetic-example", "operator": "synthetic-example", "status": "succeeded" } ], "truncated": false }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Rezultat canonic determinist, hashuri, trasare și probleme sigure mărginit." }, "CanonicalTemplateDraftOK": { "description": "Verified template draft metadata without a storage locator.", "headers": { "ETag": { "required": true, "schema": { "type": "string", "pattern": "^\"[1-9][0-9]*\"$" }, "description": "Current strong decimal draft revision ETag returned for a subsequent If-Match precondition.", "x-docula-description-ro": "ETagul puternic al reviziei zecimale curente, returnat pentru o precondiție If-Match ulterioară." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTemplateDraft" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTemplateDraftOK response", "value": { "template_id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "revision": 1, "original_filename": "synthetic-template.docx", "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "byte_size": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "bindings": [ "synthetic-example" ], "updated_by": "11111111-1111-4111-8111-000000000001", "verified_at": "2026-08-01T10:00:00Z" } } } } }, "x-docula-description-ro": "Metadatele verificate ale ciornei șablonului, fără locator de stocare." }, "CanonicalTemplateVersionsOK": { "description": "At most 100 immutable canonical template versions.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "versions" ], "properties": { "versions": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/CanonicalTemplateVersion" } } } }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTemplateVersionsOK response", "value": { "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "template_id": "11111111-1111-4111-8111-000000000001", "number": 1, "original_filename": "synthetic-template.docx", "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "byte_size": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "bindings": [ "synthetic-example" ], "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "status": "versioned" } ] } } } } }, "x-docula-description-ro": "Cel mult 100 de versiuni canonice imuabile ale șablonului." }, "CanonicalTemplateValidationOK": { "description": "Side-effect-free verification of exact stored draft content.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTemplateValidationResult" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTemplateValidationOK response", "value": { "valid": false, "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ], "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Verificare fără efecte secundare a conținutului exact stocat al ciornei." }, "CanonicalTemplateTestOK": { "description": "Bounded deterministic DOCX/PDF probe evidence without retained output.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalTemplateTestResult" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalTemplateTestOK response", "value": { "valid": false, "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ], "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Dovadă deterministă mărginită a probei DOCX/PDF, fără rezultat păstrat." }, "ConfigurationActivationOK": { "description": "The exact calendar-effective activation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationActivation" }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationActivationOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "kind": "ingestion_model", "family_id": "11111111-1111-4111-8111-000000000001", "family_slug": "synthetic-example", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z", "scheduled_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "scheduled_at": "2026-08-01T10:00:00Z", "status": "scheduled" } } } } }, "x-docula-description-ro": "Activarea exactă efectivă calendaristic." }, "ConfigurationActivationsOK": { "description": "At most 100 activation-history entries.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "activations" ], "properties": { "activations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/ConfigurationActivation" } } } }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationActivationsOK response", "value": { "activations": [ { "id": "11111111-1111-4111-8111-000000000001", "kind": "ingestion_model", "family_id": "11111111-1111-4111-8111-000000000001", "family_slug": "synthetic-example", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z", "scheduled_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "scheduled_at": "2026-08-01T10:00:00Z", "status": "scheduled" } ] } } } } }, "x-docula-description-ro": "Cel mult 100 de intrări în istoricul activărilor." }, "ConfigurationMutationOK": { "description": "A committed canonical definition mutation, cancellation, or exact actor-scoped replay.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationMutationResult" }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationMutationOK response", "value": { "resource_kind": "activation", "resource_id": "11111111-1111-4111-8111-000000000001", "result": { "kind": "ingestion_model", "family_id": "11111111-1111-4111-8111-000000000001", "family_slug": "synthetic-example", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "activation_id": "11111111-1111-4111-8111-000000000001", "effective_from": "2026-08-01T10:00:00Z", "scheduled_at": "2026-08-01T10:00:00Z" }, "response_hash": "0000000000000000000000000000000000000000000000000000000000000000", "idempotent_replay": false, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "O mutație ori anulare confirmată a definiției canonice sau o reluare exactă limitată la actor." }, "ConfigurationMutationCreated": { "description": "A canonical family, immutable version, or future activation was atomically created.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationMutationResult" }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationMutationCreated response", "value": { "resource_kind": "activation", "resource_id": "11111111-1111-4111-8111-000000000001", "result": { "kind": "ingestion_model", "family_id": "11111111-1111-4111-8111-000000000001", "family_slug": "synthetic-example", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "activation_id": "11111111-1111-4111-8111-000000000001", "effective_from": "2026-08-01T10:00:00Z", "scheduled_at": "2026-08-01T10:00:00Z" }, "response_hash": "0000000000000000000000000000000000000000000000000000000000000000", "idempotent_replay": false, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "O familie canonică, o versiune imuabilă sau o activare viitoare a fost creată atomic." }, "CanonicalReleaseValidationOK": { "description": "Side-effect-free exact release evidence or bounded compatibility errors.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalReleaseValidationResult" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalReleaseValidationOK response", "value": { "valid": false, "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ], "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Dovadă exactă a release-ului fără efecte secundare sau erori de compatibilitate mărginite." }, "CanonicalReleasePublicationOK": { "description": "Exact actor-scoped replay of an already committed canonical release identity.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CanonicalReleaseMutationResult" }, "examples": { "synthetic": { "summary": "Synthetic CanonicalReleasePublicationOK response", "value": { "resource_kind": "release", "resource_id": "11111111-1111-4111-8111-000000000001", "result": { "release": { "id": "11111111-1111-4111-8111-000000000001", "processing_kind": "transformation", "name": "synthetic-example", "description": "synthetic-example", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "transform_version_id": "11111111-1111-4111-8111-000000000001", "transform_hash": "0000000000000000000000000000000000000000000000000000000000000000", "output_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "published_at": "2026-08-01T10:00:00Z", "validation_case_id": "11111111-1111-4111-8111-000000000001", "case_hash": "0000000000000000000000000000000000000000000000000000000000000000" }, "manifest": {} }, "response_hash": "0000000000000000000000000000000000000000000000000000000000000000", "idempotent_replay": false, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Reluare exactă, limitată la actor, a identității unui release canonic deja confirmat." }, "ReleasePublicationCreated": { "description": "A legacy document release or canonical exact release was published.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ReleaseMutation" }, { "$ref": "#/components/schemas/CanonicalReleaseMutationResult" } ] }, "examples": { "synthetic": { "summary": "Synthetic ReleasePublicationCreated response", "value": { "release": { "id": "11111111-1111-4111-8111-000000000001", "processing_kind": "transformation", "name": "synthetic-example", "description": "synthetic-example", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "transform_version_id": "11111111-1111-4111-8111-000000000001", "transform_hash": "0000000000000000000000000000000000000000000000000000000000000000", "output_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "published_at": "2026-08-01T10:00:00Z", "validation_case_id": "11111111-1111-4111-8111-000000000001", "case_hash": "0000000000000000000000000000000000000000000000000000000000000000" }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "A fost publicat un release legacy de documente sau un release canonic exact." }, "ReleasePublicationProblem": { "description": "The preserved legacy Problem or bounded canonical ConfigurationProblem matching the submitted request family.", "content": { "application/problem+json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/Problem" }, { "$ref": "#/components/schemas/ConfigurationProblem" } ] }, "examples": { "synthetic": { "summary": "Synthetic ReleasePublicationProblem response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 400, "code": "internal_error", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Problem-ul legacy păstrat sau ConfigurationProblem-ul canonic mărginit care corespunde familiei cererii trimise." }, "ConfigurationAuthenticationRequired": { "description": "A valid session is required.", "x-docula-problem-code": "authentication_required", "x-docula-problem-status": 401, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 401 }, "code": { "const": "authentication_required" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationAuthenticationRequired response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 401, "code": "authentication_required", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Este necesară o sesiune validă." }, "ConfigurationForbidden": { "description": "The current role cannot access configuration, or same-origin CSRF protection rejected a mutation.", "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 403 }, "code": { "enum": [ "csrf_rejected", "forbidden" ] } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationForbidden response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "csrf_rejected", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Rolul curent nu poate accesa configurarea sau protecția CSRF same-origin a respins o mutație." }, "ConfigurationNotFound": { "description": "The requested canonical configuration resource was not found.", "x-docula-problem-code": "not_found", "x-docula-problem-status": 404, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 404 }, "code": { "const": "not_found" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationNotFound response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 404, "code": "not_found", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Resursa canonică de configurare solicitată nu a fost găsită." }, "ConfigurationMethodNotAllowed": { "description": "The method is not supported by this canonical path.", "x-docula-problem-code": "method_not_allowed", "x-docula-problem-status": 405, "headers": { "Allow": { "required": true, "schema": { "type": "string", "enum": [ "GET", "POST", "GET, POST", "GET, PATCH" ] }, "x-docula-description-ro": "Metoda sau setul exact de metode acceptate de această cale.", "description": "The exact method or method set supported by this path." } }, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 405 }, "code": { "const": "method_not_allowed" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationMethodNotAllowed response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 405, "code": "method_not_allowed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Metoda nu este acceptată de această cale canonică." }, "ConfigurationConflict": { "description": "The mutation conflicts with canonical state or prior idempotent content.", "x-docula-problem-code": "conflict", "x-docula-problem-status": 409, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 409 }, "code": { "const": "conflict" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationConflict response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 409, "code": "conflict", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Mutația intră în conflict cu starea canonică sau cu un conținut idempotent anterior." }, "ConfigurationPreconditionFailed": { "description": "The strong draft revision is malformed or stale.", "x-docula-problem-code": "precondition_failed", "x-docula-problem-status": 412, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 412 }, "code": { "const": "precondition_failed" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationPreconditionFailed response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 412, "code": "precondition_failed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Revizia puternică a ciornei este formatată greșit sau învechită." }, "ConfigurationUnsupportedMediaType": { "description": "Content-Type must be application/json.", "x-docula-problem-code": "unsupported_media_type", "x-docula-problem-status": 415, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 415 }, "code": { "const": "unsupported_media_type" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationUnsupportedMediaType response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 415, "code": "unsupported_media_type", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Content-Type trebuie să fie application/json." }, "ConfigurationValidationFailed": { "description": "The request, query, header, or canonical configuration is invalid.", "x-docula-problem-code": "validation_failed", "x-docula-problem-status": 422, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 422 }, "code": { "const": "validation_failed" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationValidationFailed response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 422, "code": "validation_failed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Cererea, query-ul, headerul sau configurarea canonică este invalidă." }, "ConfigurationPreconditionRequired": { "description": "A current strong If-Match draft revision is required.", "x-docula-problem-code": "precondition_required", "x-docula-problem-status": 428, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 428 }, "code": { "const": "precondition_required" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationPreconditionRequired response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 428, "code": "precondition_required", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Este necesară revizia curentă puternică If-Match a ciornei." }, "ConfigurationInternalError": { "description": "Canonical configuration failed safely.", "x-docula-problem-code": "internal_error", "x-docula-problem-status": 500, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 500 }, "code": { "const": "internal_error" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationInternalError response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 500, "code": "internal_error", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "Configurarea canonică a eșuat în siguranță." }, "ConfigurationDependencyUnavailable": { "description": "A canonical configuration dependency is unavailable or returned unsafe evidence.", "x-docula-problem-code": "dependency_unavailable", "x-docula-problem-status": 503, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ConfigurationProblem" }, { "properties": { "status": { "const": 503 }, "code": { "const": "dependency_unavailable" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ConfigurationDependencyUnavailable response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 503, "code": "dependency_unavailable", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "code": "synthetic-example", "stage": "synthetic-example", "resource_kind": "synthetic-example", "message": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } ] } } } } }, "x-docula-description-ro": "O dependență a configurării canonice este indisponibilă sau a returnat dovezi nesigure." }, "LiveOK": { "description": "The API process is alive.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Live" }, "examples": { "synthetic": { "summary": "Synthetic LiveOK response", "value": { "status": "live", "version": "synthetic-example", "commit": "synthetic-example" } } } } }, "x-docula-description-ro": "Procesul API este activ." }, "PublicReadinessOK": { "description": "Every required dependency is ready.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicReadiness" }, "examples": { "synthetic": { "summary": "Synthetic PublicReadinessOK response", "value": { "status": "ready", "dependencies": [ { "name": "postgresql", "status": "ready" }, { "name": "nats", "status": "unavailable" }, { "name": "s3", "status": "ready" } ] } } } } }, "x-docula-description-ro": "Fiecare dependență obligatorie este pregătită." }, "LoginOK": { "description": "A new opaque server-side session was created.", "headers": { "Set-Cookie": { "description": "The host-only session cookie.", "schema": { "type": "string" }, "x-docula-description-ro": "Cookie-ul sesiunii, limitat la host." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Session" }, "examples": { "synthetic": { "summary": "Synthetic LoginOK response", "value": { "user": { "id": "11111111-1111-4111-8111-000000000001", "username": "synthetic-user", "roles": [ "administrator" ] }, "must_change_password": false, "expires_at": "2026-08-01T10:00:00Z", "csrf_token": "synthetic-csrf-token" } } } } }, "x-docula-description-ro": "A fost creată o sesiune opacă nouă pe server." }, "SessionOK": { "description": "The current session is valid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Session" }, "examples": { "synthetic": { "summary": "Synthetic SessionOK response", "value": { "user": { "id": "11111111-1111-4111-8111-000000000001", "username": "synthetic-user", "roles": [ "administrator" ] }, "must_change_password": false, "expires_at": "2026-08-01T10:00:00Z", "csrf_token": "synthetic-csrf-token" } } } } }, "x-docula-description-ro": "Sesiunea curentă este validă." }, "PasswordChanged": { "description": "The password changed, all sessions were revoked, and the session cookie was expired.", "headers": { "Set-Cookie": { "description": "An expired session cookie.", "schema": { "type": "string" }, "x-docula-description-ro": "Cookie-ul sesiunii, limitat la host." } }, "x-docula-example": "no-body", "x-docula-description-ro": "Parola a fost schimbată, toate sesiunile au fost revocate, iar cookie-ul sesiunii a expirat." }, "LoggedOut": { "description": "The session was revoked and the session cookie was expired.", "headers": { "Set-Cookie": { "description": "An expired session cookie.", "schema": { "type": "string" }, "x-docula-description-ro": "Cookie-ul sesiunii, limitat la host." } }, "x-docula-example": "no-body", "x-docula-description-ro": "Sesiunea a fost revocată, iar cookie-ul sesiunii a expirat." }, "AdminReadinessOK": { "description": "Safe operation-level dependency status for an administrator.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Readiness" }, "examples": { "synthetic": { "summary": "Synthetic AdminReadinessOK response", "value": { "status": "ready", "dependencies": [ { "name": "postgresql", "operation": "select_one", "status": "ready" }, { "name": "nats", "operation": "connect_flush_jetstream_account_info", "status": "unavailable" }, { "name": "s3", "operation": "put_get_verify_delete", "status": "ready" }, { "name": "outbox", "operation": "outbox_backlog", "status": "ready", "outbox": { "backlog_size": 0, "oldest_unpublished_age_seconds": 0, "consumer_last_success_at": "2026-08-30T10:00:00Z", "publish_failures": 0 } } ] } } } } }, "x-docula-description-ro": "Starea sigură a dependențelor la nivel de operație pentru un administrator." }, "ContractListOK": { "description": "Contracts visible to the current role.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContractList" }, "examples": { "synthetic": { "summary": "Synthetic ContractListOK response", "value": { "contracts": [ { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "updated_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "Contractele vizibile rolului curent." }, "ContractOK": { "description": "The contract and versions visible to the current role.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Contract" }, "examples": { "synthetic": { "summary": "Synthetic ContractOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "number": 1, "schema": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "Contractul și versiunile vizibile rolului curent." }, "CaseListOK": { "description": "Deterministic cases visible to the current role.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaseList" }, "examples": { "synthetic": { "summary": "Synthetic CaseListOK response", "value": { "cases": [ { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_version_number": 1, "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "kind": "valid", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "seed": 0, "provider": "Faker", "provider_version": "40.28.1", "locale": "en_US", "generator_version": "docula-json-schema-v1", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "Cazurile deterministe vizibile rolului curent." }, "CaseOK": { "description": "A deterministic case payload and immutable provenance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Case" }, "examples": { "synthetic": { "summary": "Synthetic CaseOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_version_number": 1, "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "kind": "valid", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "seed": 0, "provider": "Faker", "provider_version": "40.28.1", "locale": "en_US", "generator_version": "docula-json-schema-v1", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "payload": "synthetic-example" } } } } }, "x-docula-description-ro": "Payloadul unui caz determinist și proveniența sa imuabilă." }, "CaseCreated": { "description": "The deterministic case and audit event were persisted atomically.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Case" }, "examples": { "synthetic": { "summary": "Synthetic CaseCreated response", "value": { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_version_number": 1, "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "kind": "valid", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "seed": 0, "provider": "Faker", "provider_version": "40.28.1", "locale": "en_US", "generator_version": "docula-json-schema-v1", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "payload": "synthetic-example" } } } } }, "x-docula-description-ro": "Cazul determinist și evenimentul de audit au fost persistate atomic." }, "TransformListOK": { "description": "Transform definitions visible to the current role.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformList" }, "examples": { "synthetic": { "summary": "Synthetic TransformListOK response", "value": { "transforms": [ { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "updated_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "Definițiile transformărilor vizibile rolului curent." }, "TransformOK": { "description": "The transform and immutable versions visible to the current role.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Transform" }, "examples": { "synthetic": { "summary": "Synthetic TransformOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "definition_id": "11111111-1111-4111-8111-000000000001", "number": 1, "source": "synthetic-example", "source_format": "yaml", "canonical_definition": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "language": "declarative-v1", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "Transformarea și versiunile imuabile vizibile rolului curent." }, "TransformCreated": { "description": "The mutable transform draft was created and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformMutation" }, "examples": { "synthetic": { "summary": "Synthetic TransformCreated response", "value": { "transform": { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "definition_id": "11111111-1111-4111-8111-000000000001", "number": 1, "source": "synthetic-example", "source_format": "yaml", "canonical_definition": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "language": "declarative-v1", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Ciorna mutabilă a transformării a fost creată și auditată." }, "TransformUpdated": { "description": "The expected transform draft revision was updated and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformMutation" }, "examples": { "synthetic": { "summary": "Synthetic TransformUpdated response", "value": { "transform": { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "definition_id": "11111111-1111-4111-8111-000000000001", "number": 1, "source": "synthetic-example", "source_format": "yaml", "canonical_definition": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "language": "declarative-v1", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Revizia așteptată a ciornei transformării a fost actualizată și auditată." }, "TransformValidationOK": { "description": "Declarative-v1 validation completed; invalid source is represented in the response body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformValidation" }, "examples": { "synthetic": { "summary": "Synthetic TransformValidationOK response", "value": { "valid": false, "errors": [ { "path": "synthetic-example", "message": "synthetic-example" } ] } } } } }, "x-docula-description-ro": "Validarea declarative-v1 s-a încheiat; sursa invalidă este reprezentată în corpul răspunsului." }, "TransformPreviewOK": { "description": "Deterministic canonical preview output and immutable case provenance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformPreview" }, "examples": { "synthetic": { "summary": "Synthetic TransformPreviewOK response", "value": { "valid": true, "errors": [], "case_id": "11111111-1111-4111-8111-000000000001", "case_hash": "0000000000000000000000000000000000000000000000000000000000000000", "output": "synthetic-example", "output_hash": "0000000000000000000000000000000000000000000000000000000000000000", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Rezultat canonic determinist al previzualizării și proveniență imuabilă a cazului." }, "TransformVersionCreated": { "description": "A sequential immutable transform version was created and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformVersionMutation" }, "examples": { "synthetic": { "summary": "Synthetic TransformVersionCreated response", "value": { "version": { "id": "11111111-1111-4111-8111-000000000001", "definition_id": "11111111-1111-4111-8111-000000000001", "number": 1, "source": "synthetic-example", "source_format": "yaml", "canonical_definition": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "language": "declarative-v1", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "A fost creată și auditată o versiune secvențială imuabilă a transformării." }, "TransformVersionUpdated": { "description": "The immutable transform version was published and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformVersionMutation" }, "examples": { "synthetic": { "summary": "Synthetic TransformVersionUpdated response", "value": { "version": { "id": "11111111-1111-4111-8111-000000000001", "definition_id": "11111111-1111-4111-8111-000000000001", "number": 1, "source": "synthetic-example", "source_format": "yaml", "canonical_definition": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "language": "declarative-v1", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Versiunea imuabilă a transformării a fost publicată și auditată." }, "TemplateListOK": { "description": "Immutable template summaries.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateList" }, "examples": { "synthetic": { "summary": "Synthetic TemplateListOK response", "value": { "templates": [ { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 0, "latest_version_number": 0, "latest_content_hash": "", "updated_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "Rezumatele șabloanelor imuabile." }, "TemplateOK": { "description": "A template and immutable versions.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Template" }, "examples": { "synthetic": { "summary": "Synthetic TemplateOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "template_id": "11111111-1111-4111-8111-000000000001", "number": 1, "original_filename": "synthetic-template.docx", "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "byte_size": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "bindings": [ "/synthetic" ], "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "status": "versioned" } ] } } } } }, "x-docula-description-ro": "Un șablon și versiunile sale imuabile." }, "TemplateCreated": { "description": "DOCX template version 1 stored and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateMutation" }, "examples": { "synthetic": { "summary": "Synthetic TemplateCreated response", "value": { "template": { "id": "11111111-1111-4111-8111-000000000001", "slug": "synthetic-example", "name": "synthetic-example", "description": "synthetic-example", "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "template_id": "11111111-1111-4111-8111-000000000001", "number": 1, "original_filename": "synthetic-template.docx", "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "byte_size": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "bindings": [ "/synthetic" ], "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "status": "versioned" } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Versiunea 1 a șablonului DOCX a fost stocată și auditată." }, "TemplateVersionCreated": { "description": "The next immutable DOCX template version stored and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateVersionMutation" }, "examples": { "synthetic": { "summary": "Synthetic TemplateVersionCreated response", "value": { "version": { "id": "11111111-1111-4111-8111-000000000001", "template_id": "11111111-1111-4111-8111-000000000001", "number": 1, "original_filename": "synthetic-template.docx", "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "byte_size": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "bindings": [ "/synthetic" ], "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "status": "versioned" }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Următoarea versiune imuabilă a șablonului DOCX a fost stocată și auditată." }, "TemplateFamilyOrLegacyCreated": { "description": "Canonical family creation or legacy immutable upload.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ConfigurationMutationResult" }, { "$ref": "#/components/schemas/TemplateMutation" } ] }, "examples": { "synthetic": { "summary": "Synthetic TemplateFamilyOrLegacyCreated response", "value": { "resource_kind": "activation", "resource_id": "11111111-1111-4111-8111-000000000001", "result": { "kind": "ingestion_model", "family_id": "11111111-1111-4111-8111-000000000001", "family_slug": "synthetic-example", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "activation_id": "11111111-1111-4111-8111-000000000001", "effective_from": "2026-08-01T10:00:00Z", "scheduled_at": "2026-08-01T10:00:00Z" }, "response_hash": "0000000000000000000000000000000000000000000000000000000000000000", "idempotent_replay": false, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Crearea familiei canonice sau încărcarea legacy imuabilă." }, "TemplateVersionOrLegacyCreated": { "description": "Canonical immutable freeze or legacy immutable upload.", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ConfigurationMutationResult" }, { "$ref": "#/components/schemas/TemplateVersionMutation" } ] }, "examples": { "synthetic": { "summary": "Synthetic TemplateVersionOrLegacyCreated response", "value": { "resource_kind": "activation", "resource_id": "11111111-1111-4111-8111-000000000001", "result": { "kind": "ingestion_model", "family_id": "11111111-1111-4111-8111-000000000001", "family_slug": "synthetic-example", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "activation_id": "11111111-1111-4111-8111-000000000001", "effective_from": "2026-08-01T10:00:00Z", "scheduled_at": "2026-08-01T10:00:00Z" }, "response_hash": "0000000000000000000000000000000000000000000000000000000000000000", "idempotent_replay": false, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Înghețare canonică imuabilă sau încărcare legacy imuabilă." }, "TemplatePreviewOK": { "description": "Deterministic resolved binding evidence.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplatePreview" }, "examples": { "synthetic": { "summary": "Synthetic TemplatePreviewOK response", "value": { "template_version_id": "11111111-1111-4111-8111-000000000001", "template_hash": "0000000000000000000000000000000000000000000000000000000000000000", "transform_version_id": "11111111-1111-4111-8111-000000000001", "transform_hash": "0000000000000000000000000000000000000000000000000000000000000000", "case_id": "11111111-1111-4111-8111-000000000001", "case_hash": "0000000000000000000000000000000000000000000000000000000000000000", "output_hash": "0000000000000000000000000000000000000000000000000000000000000000", "bindings": [ { "pointer": "/synthetic", "value": "synthetic-example" } ], "bindings_hash": "0000000000000000000000000000000000000000000000000000000000000000", "preview_hash": "0000000000000000000000000000000000000000000000000000000000000000", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Dovadă deterministă a legăturilor rezolvate." }, "ReleaseListOK": { "description": "Immutable published releases.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseList" }, "examples": { "synthetic": { "summary": "Synthetic ReleaseListOK response", "value": { "releases": [ { "id": "11111111-1111-4111-8111-000000000001", "processing_kind": "transformation", "name": "synthetic-example", "description": "synthetic-example", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "transform_version_id": "11111111-1111-4111-8111-000000000001", "transform_hash": "0000000000000000000000000000000000000000000000000000000000000000", "output_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "published_at": "2026-08-01T10:00:00Z", "validation_case_id": "11111111-1111-4111-8111-000000000001", "case_hash": "0000000000000000000000000000000000000000000000000000000000000000" } ] } } } } }, "x-docula-description-ro": "Release-uri publicate imuabile." }, "ReleaseOK": { "description": "An immutable exact release manifest.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Release" }, "examples": { "synthetic": { "summary": "Synthetic ReleaseOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "processing_kind": "transformation", "name": "synthetic-example", "description": "synthetic-example", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "transform_version_id": "11111111-1111-4111-8111-000000000001", "transform_hash": "0000000000000000000000000000000000000000000000000000000000000000", "output_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "published_at": "2026-08-01T10:00:00Z", "validation_case_id": "11111111-1111-4111-8111-000000000001", "case_hash": "0000000000000000000000000000000000000000000000000000000000000000" } } } } }, "x-docula-description-ro": "Manifestul exact al unui release imuabil." }, "ReleaseCreated": { "description": "A compatible immutable release was published and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseMutation" }, "examples": { "synthetic": { "summary": "Synthetic ReleaseCreated response", "value": { "release": { "id": "11111111-1111-4111-8111-000000000001", "processing_kind": "transformation", "name": "synthetic-example", "description": "synthetic-example", "contract_version_id": "11111111-1111-4111-8111-000000000001", "contract_hash": "0000000000000000000000000000000000000000000000000000000000000000", "transform_version_id": "11111111-1111-4111-8111-000000000001", "transform_hash": "0000000000000000000000000000000000000000000000000000000000000000", "output_hash": "0000000000000000000000000000000000000000000000000000000000000000", "manifest": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "created_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "published_at": "2026-08-01T10:00:00Z", "validation_case_id": "11111111-1111-4111-8111-000000000001", "case_hash": "0000000000000000000000000000000000000000000000000000000000000000" }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "A fost publicat și auditat un release compatibil și imuabil." }, "ExecutionListOK": { "description": "A bounded page of durable executions ordered newest first.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionList" }, "examples": { "synthetic": { "summary": "Synthetic ExecutionListOK response", "value": { "executions": [ { "id": "11111111-1111-4111-8111-000000000001", "release_id": "11111111-1111-4111-8111-000000000001", "release_hash": "0000000000000000000000000000000000000000000000000000000000000000", "processing_kind": "transformation", "input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "queued", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "steps": [ { "name": "validate", "position": 1, "status": "not_started", "attempt": 0, "state_version": 1 }, { "name": "transform.declarative", "position": 2, "status": "queued", "attempt": 1, "state_version": 2 } ], "artifacts": [] } ] } } } } }, "x-docula-description-ro": "O pagină mărginită de execuții durabile, ordonate de la cea mai nouă." }, "ExecutionOK": { "description": "Exact durable execution identity and ordered step state.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Execution" }, "examples": { "synthetic": { "summary": "Synthetic ExecutionOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "release_id": "11111111-1111-4111-8111-000000000001", "release_hash": "0000000000000000000000000000000000000000000000000000000000000000", "processing_kind": "transformation", "input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "queued", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "steps": [ { "name": "validate", "position": 1, "status": "not_started", "attempt": 0, "state_version": 1 }, { "name": "transform.declarative", "position": 2, "status": "queued", "attempt": 1, "state_version": 2 } ], "artifacts": [] } } } } }, "x-docula-description-ro": "Identitatea exactă a execuției durabile și starea ordonată a pașilor." }, "AnalyticsSummaryOK": { "description": "Bounded Submission, Ingestion, Processing, and Storage analytics with explicit sample and measurement availability.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyticsSummary" }, "examples": { "synthetic": { "summary": "Synthetic AnalyticsSummaryOK response", "value": { "from": "2026-08-01T10:00:00Z", "to": "2026-08-01T10:00:00Z", "submissions": { "count": 0, "raw_bytes": 0 }, "ingestion": { "accepted_count": 0, "rejected_count": 0, "no_processing_count": 0, "decision_latency": { "sample_count": 0, "p50_ms": null, "p95_ms": null } }, "processing": { "planned_count": 0, "attempted_count": 0, "completed_count": 0, "failed_count": 0, "derived_blocked_count": 0, "duration": { "sample_count": 0, "p50_ms": null, "p95_ms": null }, "peak_rss": { "measured_count": 0, "unavailable_count": 0, "p50_bytes": null, "p95_bytes": null } }, "processing_load": { "bucket_width_seconds": 1, "buckets": [ { "bucket_start": "2026-08-01T10:00:00Z", "ingestion": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "transformation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "docx_composition": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "pdf_generation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null } } ] }, "storage": { "docx_count": 0, "docx_bytes": 0, "pdf_count": 0, "pdf_bytes": 0 }, "rates": { "ingestion_acceptance": { "numerator": 0, "denominator": 0, "value": null }, "processing_completion": { "numerator": 0, "denominator": 0, "value": null }, "processing_failure": { "numerator": 0, "denominator": 0, "value": null } }, "failures": [ { "code": "synthetic-example", "count": 1 } ], "percentile_method": "nearest_rank", "document_generation": { "completed_render_count": 0, "window_minutes": 1, "documents_per_minute": null, "render_latency": { "sample_count": 0, "p50_ms": null, "p95_ms": null }, "render_attempt_error_rate": { "numerator": 0, "denominator": 0, "value": null }, "peak_rss": { "measured_count": 0, "unavailable_count": 0, "p50_bytes": null, "p95_bytes": null }, "queue": { "observed_at": "2026-08-01T10:00:00Z", "pending_count": 0, "in_flight_count": 0, "availability": "available", "scope": "document_compose_and_render", "method": "jetstream_consumer_info" }, "workers": { "observed_at": "2026-08-01T10:00:00Z", "responsive_replicas": 0, "busy_slots": 0, "capacity_slots": 0, "saturation_ratio": null, "availability": "available", "scope": "document_worker_replicas", "method": "bounded_nats_broadcast" } } } } } } }, "x-docula-description-ro": "Analitice mărginite pentru Submission, Ingestion, Processing și Storage, cu disponibilitatea explicită a eșantionului și măsurătorilor." }, "AnalyticsDecisionSummaryOK": { "description": "One transactionally consistent current and previous canonical decision contract with separately timestamped live operations.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyticsDecisionSummary" }, "examples": { "synthetic": { "summary": "Synthetic AnalyticsDecisionSummaryOK response", "value": { "observed_at": "2026-08-01T10:00:00Z", "current": { "from": "2026-08-01T10:00:00Z", "to": "2026-08-01T10:00:00Z", "submissions": { "count": 0, "raw_bytes": 0 }, "ingestion": { "accepted_count": 0, "rejected_count": 0, "no_processing_count": 0, "decision_latency": { "sample_count": 0, "p50_ms": null, "p95_ms": null } }, "pending_ingestion_count": 0, "processing": { "planned_count": 0, "attempted_count": 0, "completed_count": 0, "failed_count": 0, "derived_blocked_count": 0, "duration": { "sample_count": 0, "p50_ms": null, "p95_ms": null }, "peak_rss": { "measured_count": 0, "unavailable_count": 0, "p50_bytes": null, "p95_bytes": null } }, "generated_set_count": 0, "storage": { "docx_count": 0, "docx_bytes": 0, "pdf_count": 0, "pdf_bytes": 0 }, "affected_submissions": { "numerator": 0, "denominator": 0, "value": 1, "availability": "available", "reason": null }, "assessment": "no_activity", "processing_load": { "nominal_bucket_width_seconds": 3600, "buckets": [ { "bucket_start": "2026-08-01T10:00:00Z", "bucket_width_seconds": 3600, "ingestion": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "transformation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "docx_composition": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "pdf_generation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null } } ] } }, "previous": { "from": "2026-08-01T10:00:00Z", "to": "2026-08-01T10:00:00Z", "submissions": { "count": 0, "raw_bytes": 0 }, "ingestion": { "accepted_count": 0, "rejected_count": 0, "no_processing_count": 0, "decision_latency": { "sample_count": 0, "p50_ms": null, "p95_ms": null } }, "pending_ingestion_count": 0, "processing": { "planned_count": 0, "attempted_count": 0, "completed_count": 0, "failed_count": 0, "derived_blocked_count": 0, "duration": { "sample_count": 0, "p50_ms": null, "p95_ms": null }, "peak_rss": { "measured_count": 0, "unavailable_count": 0, "p50_bytes": null, "p95_bytes": null } }, "generated_set_count": 0, "storage": { "docx_count": 0, "docx_bytes": 0, "pdf_count": 0, "pdf_bytes": 0 }, "affected_submissions": { "numerator": 0, "denominator": 0, "value": 1, "availability": "available", "reason": null }, "assessment": "no_activity", "processing_load": { "nominal_bucket_width_seconds": 3600, "buckets": [ { "bucket_start": "2026-08-01T10:00:00Z", "bucket_width_seconds": 3600, "ingestion": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "transformation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "docx_composition": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "pdf_generation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null } } ] } }, "comparisons": { "submissions": { "availability": "available", "reason": null }, "processing_completion": { "availability": "available", "reason": null }, "generated_sets": { "availability": "available", "reason": null }, "affected_submissions": { "availability": "available", "reason": null } }, "error_group_count": 0, "error_groups_truncated": false, "error_groups": [ { "current": { "scope": "ingestion_rejection", "code": "synthetic_example", "affected_submission_count": 0, "affected_node_count": null, "submission_denominator": 0, "rate": { "numerator": 0, "denominator": 0, "value": 1, "availability": "available", "reason": null } }, "previous": { "scope": "ingestion_rejection", "code": "synthetic_example", "affected_submission_count": 0, "affected_node_count": null, "submission_denominator": 0, "rate": { "numerator": 0, "denominator": 0, "value": 1, "availability": "available", "reason": null } }, "comparison": { "count": { "availability": "available", "reason": null }, "rate": { "availability": "available", "reason": null } } } ], "percentile_method": "nearest_rank", "live_operations": { "queue": { "observed_at": "2026-08-01T10:00:00Z", "pending_count": 0, "in_flight_count": 0, "availability": "available", "scope": "document_compose_and_render", "method": "jetstream_consumer_info" }, "workers": { "observed_at": "2026-08-01T10:00:00Z", "responsive_replicas": 0, "busy_slots": 0, "capacity_slots": 0, "saturation_ratio": null, "availability": "available", "scope": "document_worker_replicas", "method": "bounded_nats_broadcast" } } } } } } }, "x-docula-description-ro": "Un contract canonic al deciziei curente și precedente, consistent tranzacțional, cu operațiuni live marcate temporal separat." }, "AnalyticsProcessingContributorsOK": { "description": "One refreshed processing-load bucket and its bounded canonical contributors.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyticsProcessingContributorPage" }, "examples": { "synthetic": { "summary": "Synthetic AnalyticsProcessingContributorsOK response", "value": { "observed_at": "2026-08-01T10:00:00Z", "bucket": { "bucket_start": "2026-08-01T10:00:00Z", "bucket_width_seconds": 3600, "ingestion": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "transformation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "docx_composition": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null }, "pdf_generation": { "duration_ms": 0, "operation_count": 0, "average_duration_ms": null } }, "items": [ { "kind": "ingestion_submission", "submission_id": "11111111-1111-4111-8111-000000000001", "submission_path": "/api/v1/submissions/11111111-1111-4111-8111-111111111111", "contribution_duration_ms": 0 } ], "next_cursor": null } } } } }, "x-docula-description-ro": "Un bucket actualizat al încărcării procesării și contributorii săi canonici mărginiți." }, "AnalyticsFailureContributorsOK": { "description": "One refreshed failure group and its bounded canonical contributors.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyticsFailureContributorPage" }, "examples": { "synthetic": { "summary": "Synthetic AnalyticsFailureContributorsOK response", "value": { "observed_at": "2026-08-01T10:00:00Z", "group": { "scope": "ingestion_rejection", "code": "synthetic_example", "affected_submission_count": 0, "affected_node_count": null, "submission_denominator": 0, "rate": { "numerator": 0, "denominator": 0, "value": 1, "availability": "available", "reason": null } }, "items": [ { "kind": "ingestion_submission", "submission_id": "11111111-1111-4111-8111-000000000001", "submission_path": "/api/v1/submissions/11111111-1111-4111-8111-111111111111" } ], "next_cursor": null } } } } }, "x-docula-description-ro": "Un grup actualizat de erori și contributorii săi canonici mărginiți." }, "SubmissionListOK": { "description": "A stable newest-first bounded page containing each matching Submission exactly once.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmissionList" }, "examples": { "synthetic": { "summary": "Synthetic SubmissionListOK response", "value": { "submissions": [ { "id": "11111111-1111-4111-8111-000000000001", "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "received_at": "2026-08-01T10:00:00Z", "ingestion_outcome": "received", "processing_triggered": false, "processing_outcome": "not_triggered", "storage_object_count": 0, "storage_bytes": 0 } ] } } } } }, "x-docula-description-ro": "O pagină stabilă mărginită, ordonată de la cea mai nouă, care conține fiecare Submission corespunzător exact o dată." }, "TransformationListOK": { "description": "A stable newest-first bounded PostgreSQL projection of canonical transformation nodes.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformationPage" }, "examples": { "synthetic": { "summary": "Synthetic TransformationListOK response", "value": { "transformations": [ { "id": "11111111-1111-4111-8111-000000000001", "submission_id": "11111111-1111-4111-8111-000000000001", "object_reference": "DOCS-EXAMPLE-0001", "model_slug": "synthetic-example", "name": "synthetic-example", "slug": "synthetic-example", "address": "document:render", "status": "pending", "attempt_count": 0, "created_at": "2026-08-01T10:00:00Z" } ] } } } } }, "x-docula-description-ro": "O proiecție PostgreSQL stabilă și mărginită a nodurilor canonice de transformare, ordonată de la cea mai nouă." }, "StorageListOK": { "description": "A stable newest-first bounded PostgreSQL projection of successful retained artifacts.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoragePage" }, "examples": { "synthetic": { "summary": "Synthetic StorageListOK response", "value": { "storage": [ { "artifact_id": "11111111-1111-4111-8111-000000000001", "submission_id": "11111111-1111-4111-8111-000000000001", "object_reference": "DOCS-EXAMPLE-0001", "model_slug": "synthetic-example", "producing_node_label": "synthetic-example", "producing_node_address": "document:render", "format": "docx", "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "byte_size": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "created_at": "2026-08-01T10:00:00Z", "download_path": "/api/v1/executions/11111111-1111-4111-8111-111111111111/artifacts/22222222-2222-4222-8222-222222222222/download" } ] } } } } }, "x-docula-description-ro": "O proiecție PostgreSQL stabilă și mărginită a artefactelor reușite păstrate, ordonată de la cel mai nou." }, "SubmissionGraphOK": { "description": "One transactionally consistent Submission graph with at most 100 elements and 100 dependency edges.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmissionGraph" }, "examples": { "synthetic": { "summary": "Synthetic SubmissionGraphOK response", "value": { "submission": { "id": "11111111-1111-4111-8111-000000000001", "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "received_at": "2026-08-01T10:00:00Z", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "original_evidence": { "available": false } }, "ingestion": { "id": "11111111-1111-4111-8111-000000000001", "outcome": "received", "processing_triggered": false, "selection_snapshot": [ { "kind": "transformation", "name": "synthetic-example", "slug": "synthetic-example", "address": "synthetic-example", "position": 1 } ] }, "processing_outcome": "not_triggered", "processing": [ { "id": "11111111-1111-4111-8111-000000000001", "submission_id": "11111111-1111-4111-8111-000000000001", "kind": "transformation", "name": "synthetic-example", "slug": "synthetic-example", "address": "synthetic-example", "position": 1, "transform": { "family_id": "11111111-1111-4111-8111-000000000001", "activation_id": "11111111-1111-4111-8111-000000000001", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "slug": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z" }, "release": { "id": "11111111-1111-4111-8111-000000000001", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000" }, "status": "pending", "attempt_count": 0, "peak_rss_bytes": null, "peak_rss_availability": "measured", "content": { "available": false } } ], "storage": [ { "id": "11111111-1111-4111-8111-000000000001", "producing_node_id": "11111111-1111-4111-8111-000000000001", "execution_id": "11111111-1111-4111-8111-000000000001", "format": "docx", "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "byte_size": 1, "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "created_at": "2026-08-01T10:00:00Z", "download_path": "/api/v1/executions/11111111-1111-4111-8111-111111111111/artifacts/22222222-2222-4222-8222-222222222222/download" } ], "configuration_provenance": [ { "component_kind": "ingestion_model", "node_address": "synthetic-example", "resource_id": "11111111-1111-4111-8111-000000000001", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "deployment_available": false } ] } } } } }, "x-docula-description-ro": "Un graf Submission consistent tranzacțional, cu cel mult 100 de elemente și 100 de muchii de dependență." }, "SubmissionElementOK": { "description": "One typed element owned by the requested Submission, with bounded evidence metadata.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubmissionElement" }, "examples": { "synthetic": { "summary": "Synthetic SubmissionElementOK response", "value": { "id": "11111111-1111-4111-8111-000000000001", "kind": "submission", "content": { "available": false } } } } } }, "x-docula-description-ro": "Un element tipizat deținut de Submission-ul solicitat, cu metadate mărginite ale dovezii." }, "SubmissionElementContentOK": { "description": "Exact authorized original or intermediate JSON bytes.", "headers": { "Content-Length": { "schema": { "type": "integer", "minimum": 1, "maximum": 524288 }, "description": "Exact byte length of the returned content.", "x-docula-description-ro": "Lungimea exactă în octeți a conținutului returnat." }, "X-Content-SHA256": { "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "description": "Lowercase hexadecimal SHA-256 digest of the exact returned bytes.", "x-docula-description-ro": "Digestul SHA-256 hexazecimal cu litere mici al octeților exacți returnați." } }, "content": { "application/json": { "schema": { "x-docula-max-bytes": 524288 }, "examples": { "synthetic": { "summary": "Synthetic SubmissionElementContentOK response", "value": "synthetic-example" } } } }, "x-docula-description-ro": "Octeții JSON exacți autorizați, originali sau intermediari." }, "SubmissionAccepted": { "description": "The valid request was persisted before its ingestion decision and returned without replaying prior work.", "headers": { "Location": { "description": "Canonical resource path for the created or replayed result.", "schema": { "type": "string", "pattern": "^/api/v1/submissions/[0-9a-f-]{36}$" }, "x-docula-description-ro": "Calea canonică a resursei pentru rezultatul creat sau reluat." } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/SubmissionMutation" }, { "type": "object", "properties": { "idempotent_replay": { "const": false } } } ] }, "examples": { "synthetic": { "summary": "Synthetic SubmissionAccepted response", "value": { "submission": { "id": "11111111-1111-4111-8111-000000000001", "ingestion_id": "11111111-1111-4111-8111-000000000001", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "original_payload_hash": "0000000000000000000000000000000000000000000000000000000000000000", "canonical_payload_hash": "0000000000000000000000000000000000000000000000000000000000000000", "request_hash": "0000000000000000000000000000000000000000000000000000000000000000", "ingestion_status": "received", "processing_triggered": false, "received_at": "2026-08-01T10:00:00Z", "plan": [ { "id": "11111111-1111-4111-8111-000000000001", "submission_id": "11111111-1111-4111-8111-000000000001", "kind": "transformation", "name": "synthetic-example", "slug": "synthetic-example", "address": "synthetic-example", "position": 1, "transform": { "family_id": "11111111-1111-4111-8111-000000000001", "activation_id": "11111111-1111-4111-8111-000000000001", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "slug": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z" }, "release": { "id": "11111111-1111-4111-8111-000000000001", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000" } } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001", "result_url": "/api/v1/submissions/11111111-1111-4111-8111-111111111111", "idempotent_replay": false } } } } }, "x-docula-description-ro": "Cererea validă a fost persistată înaintea deciziei de ingestie și returnată fără reluarea procesării anterioare." }, "SubmissionReplay": { "description": "The exact actor-scoped idempotent request replayed the originally pinned Submission and selection.", "headers": { "Location": { "description": "Canonical resource path for the created or replayed result.", "schema": { "type": "string", "pattern": "^/api/v1/submissions/[0-9a-f-]{36}$" }, "x-docula-description-ro": "Calea canonică a resursei pentru rezultatul creat sau reluat." }, "Idempotent-Replay": { "description": "True when the response replays an earlier exact actor-scoped request without new work.", "schema": { "type": "string", "const": "true" }, "x-docula-description-ro": "True când răspunsul reia o cerere exactă anterioară, limitată la actor, fără procesare nouă." } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/SubmissionMutation" }, { "type": "object", "properties": { "idempotent_replay": { "const": true } } } ] }, "examples": { "synthetic": { "summary": "Synthetic SubmissionReplay response", "value": { "submission": { "id": "11111111-1111-4111-8111-000000000001", "ingestion_id": "11111111-1111-4111-8111-000000000001", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "original_payload_hash": "0000000000000000000000000000000000000000000000000000000000000000", "canonical_payload_hash": "0000000000000000000000000000000000000000000000000000000000000000", "request_hash": "0000000000000000000000000000000000000000000000000000000000000000", "ingestion_status": "received", "processing_triggered": false, "received_at": "2026-08-01T10:00:00Z", "plan": [ { "id": "11111111-1111-4111-8111-000000000001", "submission_id": "11111111-1111-4111-8111-000000000001", "kind": "transformation", "name": "synthetic-example", "slug": "synthetic-example", "address": "synthetic-example", "position": 1, "transform": { "family_id": "11111111-1111-4111-8111-000000000001", "activation_id": "11111111-1111-4111-8111-000000000001", "version_id": "11111111-1111-4111-8111-000000000001", "version": 1, "slug": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "effective_from": "2026-08-01T10:00:00Z" }, "release": { "id": "11111111-1111-4111-8111-000000000001", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000" } } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001", "result_url": "/api/v1/submissions/11111111-1111-4111-8111-111111111111", "idempotent_replay": true } } } } }, "x-docula-description-ro": "Cererea idempotentă exactă limitată la actor a reluat Submission-ul și selecția fixate inițial." }, "RCADemoCatalogOK": { "description": "Exactly five immutable embedded RCA scenarios with exact source payload bytes and hash evidence.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RCADemoCatalog" }, "examples": { "synthetic": { "summary": "Synthetic RCADemoCatalogOK response", "value": { "fixture_family": "polita-rca-v1", "scenarios": [ { "id": "1-month", "name": "synthetic-example", "description": "synthetic-example", "expected_ingestion": "accepted", "expected_person_branch": "succeeded", "schedule_interval_months": 1, "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "source_payload": "synthetic-example", "source_payload_media_type": "application/json", "source_payload_bytes": 1, "source_payload_sha256": "0000000000000000000000000000000000000000000000000000000000000000", "ui_facts": { "outcome_label": "synthetic-example", "schedule_label": "synthetic-example", "journey_summary": "synthetic-example", "expected_transformations": 4, "expected_documents": 5, "blocked_nodes": [] } }, { "id": "6-month", "name": "synthetic-example", "description": "synthetic-example", "expected_ingestion": "accepted", "expected_person_branch": "succeeded", "schedule_interval_months": 6, "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "source_payload": "synthetic-example", "source_payload_media_type": "application/json", "source_payload_bytes": 2, "source_payload_sha256": "0000000000000000000000000000000000000000000000000000000000000000", "ui_facts": { "outcome_label": "synthetic-example", "schedule_label": "synthetic-example", "journey_summary": "synthetic-example", "expected_transformations": 4, "expected_documents": 5, "blocked_nodes": [] } }, { "id": "12-month", "name": "synthetic-example", "description": "synthetic-example", "expected_ingestion": "accepted", "expected_person_branch": "succeeded", "schedule_interval_months": 12, "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "source_payload": "synthetic-example", "source_payload_media_type": "application/json", "source_payload_bytes": 3, "source_payload_sha256": "0000000000000000000000000000000000000000000000000000000000000000", "ui_facts": { "outcome_label": "synthetic-example", "schedule_label": "synthetic-example", "journey_summary": "synthetic-example", "expected_transformations": 4, "expected_documents": 5, "blocked_nodes": [] } }, { "id": "ingestion-rejection", "name": "synthetic-example", "description": "synthetic-example", "expected_ingestion": "rejected", "expected_person_branch": "not_started", "schedule_interval_months": 12, "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "source_payload": "synthetic-example", "source_payload_media_type": "application/json", "source_payload_bytes": 4, "source_payload_sha256": "0000000000000000000000000000000000000000000000000000000000000000", "ui_facts": { "outcome_label": "synthetic-example", "schedule_label": "synthetic-example", "journey_summary": "synthetic-example", "expected_transformations": 0, "expected_documents": 0, "blocked_nodes": [] } }, { "id": "person-branch-failure", "name": "synthetic-example", "description": "synthetic-example", "expected_ingestion": "accepted", "expected_person_branch": "failed", "schedule_interval_months": 6, "metadata": { "model_slug": "synthetic-example", "object_reference": "DOCS-EXAMPLE-0001", "object_effective_at": "2026-08-01T10:00:00Z", "source_system": "synthetic-example", "source_actor": "synthetic-example" }, "source_payload": "synthetic-example", "source_payload_media_type": "application/json", "source_payload_bytes": 5, "source_payload_sha256": "0000000000000000000000000000000000000000000000000000000000000000", "ui_facts": { "outcome_label": "synthetic-example", "schedule_label": "synthetic-example", "journey_summary": "synthetic-example", "expected_transformations": 4, "expected_documents": 3, "blocked_nodes": [ "gdpr", "fisa-t-plus-1" ], "failed_node": "date-persoana" } } ] } } } } }, "x-docula-description-ro": "Exact cinci scenarii RCA imuabile încorporate, cu octeții exacți ai payloadului sursă și dovada hashului." }, "DemoCatalogOK": { "description": "Canonical synthetic scenario catalog and shared-release readiness.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemoCatalog" }, "examples": { "synthetic": { "summary": "Synthetic DemoCatalogOK response", "value": { "fixture_family": "clws-policy-v1", "ready": false, "scenarios": [ { "id": "monthly", "name": "synthetic-example", "description": "synthetic-example", "expected_outcome": "synthetic-example", "schedule_interval_months": 1, "raw_input": "synthetic-example", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "metadata": { "schema": "docula-intake-metadata-v1", "source_object": "synthetic-example", "source_timestamp": "synthetic-example", "source_actor": "synthetic-example", "source_system": "synthetic-example", "fixture_family": "synthetic-example", "scenario_id": "11111111-1111-4111-8111-000000000001", "schedule_interval_months": 1 } }, { "id": "semiannual", "name": "synthetic-example", "description": "synthetic-example", "expected_outcome": "synthetic-example", "schedule_interval_months": 6, "raw_input": "synthetic-example", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "metadata": { "schema": "docula-intake-metadata-v1", "source_object": "synthetic-example", "source_timestamp": "synthetic-example", "source_actor": "synthetic-example", "source_system": "synthetic-example", "fixture_family": "synthetic-example", "scenario_id": "11111111-1111-4111-8111-000000000002", "schedule_interval_months": 6 } }, { "id": "annual", "name": "synthetic-example", "description": "synthetic-example", "expected_outcome": "synthetic-example", "schedule_interval_months": 12, "raw_input": "synthetic-example", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "metadata": { "schema": "docula-intake-metadata-v1", "source_object": "synthetic-example", "source_timestamp": "synthetic-example", "source_actor": "synthetic-example", "source_system": "synthetic-example", "fixture_family": "synthetic-example", "scenario_id": "11111111-1111-4111-8111-000000000003", "schedule_interval_months": 12 } }, { "id": "invalid", "name": "synthetic-example", "description": "synthetic-example", "expected_outcome": "synthetic-example", "schedule_interval_months": 1, "raw_input": "synthetic-example", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "metadata": { "schema": "docula-intake-metadata-v1", "source_object": "synthetic-example", "source_timestamp": "synthetic-example", "source_actor": "synthetic-example", "source_system": "synthetic-example", "fixture_family": "synthetic-example", "scenario_id": "11111111-1111-4111-8111-000000000004", "schedule_interval_months": 1 } } ] } } } } }, "x-docula-description-ro": "Catalogul canonic al scenariilor sintetice și starea de pregătire a release-ului comun." }, "DemoHistoryOK": { "description": "Newest persisted executions in the fixed fixture cohort.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemoHistory" }, "examples": { "synthetic": { "summary": "Synthetic DemoHistoryOK response", "value": { "executions": [ { "id": "11111111-1111-4111-8111-000000000001", "release_id": "11111111-1111-4111-8111-000000000001", "release_hash": "0000000000000000000000000000000000000000000000000000000000000000", "processing_kind": "transformation", "input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "queued", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "steps": [ { "name": "validate", "position": 1, "status": "not_started", "attempt": 0, "state_version": 1 }, { "name": "transform.declarative", "position": 2, "status": "queued", "attempt": 1, "state_version": 2 } ], "artifacts": [] } ] } } } } }, "x-docula-description-ro": "Cele mai noi execuții persistate din cohorta fixă de fixture-uri." }, "DemoStatisticsOK": { "description": "Measured-only intake, terminal, artifact, and stage aggregates with exact sample/window provenance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DemoStatistics" }, "examples": { "synthetic": { "summary": "Synthetic DemoStatisticsOK response", "value": { "fixture_family": "clws-policy-v1", "intake_count": 0, "terminal_count": 0, "succeeded_count": 0, "failed_count": 0, "raw_bytes": 0, "generated_document_count": 0, "docx_count": 0, "pdf_count": 0, "stage_durations": [ { "name": "validate", "sample_count": 1 } ], "observation_window_ms": 0, "percentile_method": "nearest-rank" } } } } }, "x-docula-description-ro": "Agregate măsurate exclusiv pentru intake, stări terminale, artefacte și etape, cu proveniența exactă a eșantionului și ferestrei." }, "ExecutionEventStream": { "description": "Persisted events are replayed by numeric ID before live updates; comment frames are keepalives.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "Disables intermediary and browser caching for the event stream.", "x-docula-description-ro": "Dezactivează cache-ul intermediarilor și al browserului pentru fluxul de evenimente." }, "X-Accel-Buffering": { "schema": { "type": "string", "const": "no" }, "description": "Disables reverse-proxy buffering so persisted and live events are delivered promptly.", "x-docula-description-ro": "Dezactivează bufferingul reverse proxy-ului pentru livrarea promptă a evenimentelor persistate și live." } }, "content": { "text/event-stream": { "schema": { "type": "string" }, "examples": { "synthetic": { "summary": "Synthetic ExecutionEventStream response", "value": "id: 1\nevent: state\ndata: {\"status\":\"processing\"}\n\n" } } } }, "x-docula-description-ro": "Evenimentele persistate sunt reluate după ID-ul numeric înaintea actualizărilor live; cadrele de comentariu sunt keepalive-uri." }, "SubmissionEventStream": { "description": "Safe persisted aggregate Submission events are replayed by numeric ID before live updates; comment frames are keepalives.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" }, "description": "Disables intermediary and browser caching for the event stream.", "x-docula-description-ro": "Dezactivează cache-ul intermediarilor și al browserului pentru fluxul de evenimente." }, "X-Accel-Buffering": { "schema": { "type": "string", "const": "no" }, "description": "Disables reverse-proxy buffering so persisted and live events are delivered promptly.", "x-docula-description-ro": "Dezactivează bufferingul reverse proxy-ului pentru livrarea promptă a evenimentelor persistate și live." } }, "content": { "text/event-stream": { "schema": { "type": "string" }, "examples": { "synthetic": { "summary": "Synthetic SubmissionEventStream response", "value": "id: 1\nevent: state\ndata: {\"status\":\"processing\"}\n\n" } } } }, "x-docula-description-ro": "Evenimentele agregate sigure și persistate ale Submission-ului sunt reluate după ID-ul numeric înaintea actualizărilor live; cadrele de comentariu sunt keepalive-uri." }, "ArtifactDownload": { "description": "Verified canonical artifact bytes returned only after access is audited.", "headers": { "Content-Disposition": { "schema": { "type": "string", "pattern": "^attachment; filename=\\\"document[.](docx|pdf)\\\"$" }, "description": "Safe attachment filename for the authorized artifact bytes.", "x-docula-description-ro": "Numele sigur al fișierului atașat pentru octeții artefactului autorizat." }, "X-Content-SHA256": { "schema": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "description": "Lowercase hexadecimal SHA-256 digest of the exact returned bytes.", "x-docula-description-ro": "Digestul SHA-256 hexazecimal cu litere mici al octeților exacți returnați." } }, "content": { "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { "schema": { "type": "string", "format": "binary" }, "examples": { "synthetic": { "summary": "Synthetic ArtifactDownload response", "value": "synthetic-file-content" } } }, "application/pdf": { "schema": { "type": "string", "format": "binary" }, "examples": { "synthetic": { "summary": "Synthetic ArtifactDownload response", "value": "synthetic-file-content" } } } }, "x-docula-description-ro": "Octeții verificați ai artefactului canonic sunt returnați numai după auditarea accesului." }, "AuditListOK": { "description": "A stable newest-first page of append-only audit evidence.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditList" }, "examples": { "synthetic": { "summary": "Synthetic AuditListOK response", "value": { "events": [ { "id": "11111111-1111-4111-8111-000000000001", "occurred_at": "2026-08-01T10:00:00Z", "actor_kind": "system", "action": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "outcome": "success", "metadata": {} } ] } } } } }, "x-docula-description-ro": "O pagină stabilă a dovezilor de audit append-only, ordonată de la cea mai nouă." }, "ExecutionAccepted": { "description": "A new canonical execution, ordered steps, audit event, and validate outbox event were stored atomically.", "headers": { "Location": { "description": "Canonical resource path for the created or replayed result.", "schema": { "type": "string", "pattern": "^/api/v1/executions/[0-9a-f-]{36}$" }, "x-docula-description-ro": "Calea canonică a resursei pentru rezultatul creat sau reluat." } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ExecutionMutation" }, { "type": "object", "properties": { "idempotent_replay": { "const": false } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ExecutionAccepted response", "value": { "execution": { "id": "11111111-1111-4111-8111-000000000001", "release_id": "11111111-1111-4111-8111-000000000001", "release_hash": "0000000000000000000000000000000000000000000000000000000000000000", "processing_kind": "transformation", "input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "queued", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "steps": [ { "name": "validate", "position": 1, "status": "not_started", "attempt": 0, "state_version": 1 }, { "name": "transform.declarative", "position": 2, "status": "queued", "attempt": 1, "state_version": 2 } ], "artifacts": [] }, "correlation_id": "11111111-1111-4111-8111-000000000001", "idempotent_replay": false } } } } }, "x-docula-description-ro": "O execuție canonică nouă, pașii ordonați, evenimentul de audit și evenimentul validate din outbox au fost stocate atomic." }, "ExecutionReplay": { "description": "The exact actor-scoped idempotent request replayed the original execution without new canonical work.", "headers": { "Location": { "description": "Canonical resource path for the created or replayed result.", "schema": { "type": "string", "pattern": "^/api/v1/executions/[0-9a-f-]{36}$" }, "x-docula-description-ro": "Calea canonică a resursei pentru rezultatul creat sau reluat." }, "Idempotent-Replay": { "description": "True when the response replays an earlier exact actor-scoped request without new work.", "schema": { "type": "string", "const": "true" }, "x-docula-description-ro": "True când răspunsul reia o cerere exactă anterioară, limitată la actor, fără procesare nouă." } }, "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ExecutionMutation" }, { "type": "object", "properties": { "idempotent_replay": { "const": true } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ExecutionReplay response", "value": { "execution": { "id": "11111111-1111-4111-8111-000000000001", "release_id": "11111111-1111-4111-8111-000000000001", "release_hash": "0000000000000000000000000000000000000000000000000000000000000000", "processing_kind": "transformation", "input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "queued", "submitted_by": "11111111-1111-4111-8111-000000000001", "correlation_id": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "steps": [ { "name": "validate", "position": 1, "status": "not_started", "attempt": 0, "state_version": 1 }, { "name": "transform.declarative", "position": 2, "status": "queued", "attempt": 1, "state_version": 2 } ], "artifacts": [] }, "correlation_id": "11111111-1111-4111-8111-000000000001", "idempotent_replay": true } } } } }, "x-docula-description-ro": "Cererea idempotentă exactă limitată la actor a reluat execuția inițială fără procesare canonică nouă." }, "MutationRejected": { "description": "The session protection failed or the authenticated role cannot mutate this resource.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/MutationProblem" }, "examples": { "synthetic": { "summary": "Synthetic MutationRejected response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "csrf_rejected", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Protecția sesiunii a eșuat sau rolul autentificat nu poate modifica această resursă." }, "ValidationFailedDetailed": { "description": "The request, DOCX, or exact release components are invalid; bounded details are included when available.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ValidationProblem" }, "examples": { "synthetic": { "summary": "Synthetic ValidationFailedDetailed response", "value": { "type": "/problems/validation_failed", "title": "synthetic-example", "status": 422, "code": "validation_failed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Cererea, fișierul DOCX sau componentele exacte ale release-ului sunt invalide; detaliile mărginite sunt incluse când sunt disponibile." }, "ContractCreated": { "description": "The mutable contract draft was created and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContractMutation" }, "examples": { "synthetic": { "summary": "Synthetic ContractCreated response", "value": { "contract": { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "number": 1, "schema": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Ciorna mutabilă a contractului a fost creată și auditată." }, "ContractUpdated": { "description": "The expected draft revision was updated and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContractMutation" }, "examples": { "synthetic": { "summary": "Synthetic ContractUpdated response", "value": { "contract": { "id": "11111111-1111-4111-8111-000000000001", "name": "synthetic-example", "description": "synthetic-example", "draft_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z", "updated_at": "2026-08-01T10:00:00Z", "versions": [ { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "number": 1, "schema": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" } ] }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Revizia așteptată a ciornei a fost actualizată și auditată." }, "ContractValidationOK": { "description": "Draft 2020-12 validation completed; invalid schema content is represented in the response body.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SchemaValidation" }, "examples": { "synthetic": { "summary": "Synthetic ContractValidationOK response", "value": { "valid": false, "errors": [ { "path": "synthetic-example", "message": "synthetic-example" } ] } } } } }, "x-docula-description-ro": "Validarea ciornei Draft 2020-12 s-a încheiat; conținutul invalid al schemei este reprezentat în corpul răspunsului." }, "VersionCreated": { "description": "A sequential immutable contract version was created and audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VersionMutation" }, "examples": { "synthetic": { "summary": "Synthetic VersionCreated response", "value": { "version": { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "number": 1, "schema": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "A fost creată și auditată o versiune secvențială imuabilă a contractului." }, "VersionUpdated": { "description": "The immutable version lifecycle state changed atomically and was audited.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VersionMutation" }, "examples": { "synthetic": { "summary": "Synthetic VersionUpdated response", "value": { "version": { "id": "11111111-1111-4111-8111-000000000001", "contract_id": "11111111-1111-4111-8111-000000000001", "number": 1, "schema": "synthetic-example", "content_hash": "0000000000000000000000000000000000000000000000000000000000000000", "status": "versioned", "source_revision": 1, "created_by": "11111111-1111-4111-8111-000000000001", "created_at": "2026-08-01T10:00:00Z" }, "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Starea ciclului de viață al versiunii imuabile s-a schimbat atomic și a fost auditată." }, "ContractMutationDenied": { "description": "The session failed CSRF validation or lacks contract-write permission.", "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 403 }, "code": { "enum": [ "csrf_rejected", "forbidden" ] } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ContractMutationDenied response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "csrf_rejected", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Sesiunea nu a trecut validarea CSRF sau nu are permisiunea contract-write." }, "CaseMutationDenied": { "description": "The session failed CSRF validation or lacks case-write permission.", "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 403 }, "code": { "enum": [ "csrf_rejected", "forbidden" ] } } } ] }, "examples": { "synthetic": { "summary": "Synthetic CaseMutationDenied response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "csrf_rejected", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Sesiunea nu a trecut validarea CSRF sau nu are permisiunea case-write." }, "TransformMutationDenied": { "description": "The session failed CSRF validation or lacks transform-write permission.", "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 403 }, "code": { "enum": [ "csrf_rejected", "forbidden" ] } } } ] }, "examples": { "synthetic": { "summary": "Synthetic TransformMutationDenied response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "csrf_rejected", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Sesiunea nu a trecut validarea CSRF sau nu are permisiunea transform-write." }, "TransformValidationFailed": { "description": "The declarative source or input case could not be evaluated.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/TransformValidationProblem" }, "examples": { "synthetic": { "summary": "Synthetic TransformValidationFailed response", "value": { "type": "/problems/validation_failed", "title": "synthetic-example", "status": 422, "code": "validation_failed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001", "errors": [ { "path": "synthetic-example", "message": "synthetic-example" } ] } } } } }, "x-docula-description-ro": "Sursa declarativă sau cazul de intrare nu a putut fi evaluat." }, "InternalError": { "description": "An internal handler failure occurred.", "x-docula-problem-code": "internal_error", "x-docula-problem-status": 500, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 500 }, "code": { "const": "internal_error" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic InternalError response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 500, "code": "internal_error", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "A apărut o eroare internă în handler." }, "DependencyUnavailable": { "description": "A required dependency is unavailable.", "x-docula-problem-code": "dependency_unavailable", "x-docula-problem-status": 503, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 503 }, "code": { "const": "dependency_unavailable" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic DependencyUnavailable response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 503, "code": "dependency_unavailable", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "O dependență obligatorie este indisponibilă." }, "InvalidCredentials": { "description": "The supplied credentials are invalid.", "x-docula-problem-code": "invalid_credentials", "x-docula-problem-status": 401, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 401 }, "code": { "const": "invalid_credentials" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic InvalidCredentials response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 401, "code": "invalid_credentials", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Credențialele furnizate sunt invalide." }, "OriginRejected": { "description": "The login request lacks one unambiguous configured Origin or Referer whose host exactly matches the request Host.", "x-docula-problem-code": "origin_rejected", "x-docula-problem-status": 403, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 403 }, "code": { "const": "origin_rejected" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic OriginRejected response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "origin_rejected", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Cererii de autentificare îi lipsește un Origin sau Referer configurat, neambiguu, al cărui host să coincidă exact cu Host-ul cererii." }, "ValidationFailed": { "description": "The request is invalid.", "x-docula-problem-code": "validation_failed", "x-docula-problem-status": 422, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 422 }, "code": { "const": "validation_failed" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ValidationFailed response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 422, "code": "validation_failed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Cererea este invalidă." }, "RateLimited": { "description": "The bounded authentication attempt limit was reached.", "x-docula-problem-code": "rate_limited", "x-docula-problem-status": 429, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 429 }, "code": { "const": "rate_limited" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic RateLimited response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 429, "code": "rate_limited", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "A fost atinsă limita mărginită a încercărilor de autentificare." }, "AuthenticationRequired": { "description": "A valid server-side session is required.", "x-docula-problem-code": "authentication_required", "x-docula-problem-status": 401, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 401 }, "code": { "const": "authentication_required" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic AuthenticationRequired response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 401, "code": "authentication_required", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Este necesară o sesiune validă pe server." }, "CSRFRejected": { "description": "The request Origin is not one configured exact origin for the request Host, or the CSRF token is invalid for the host-bound session.", "x-docula-problem-code": "csrf_rejected", "x-docula-problem-status": 403, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 403 }, "code": { "const": "csrf_rejected" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic CSRFRejected response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "csrf_rejected", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Origin-ul cererii nu este una dintre originile exacte configurate pentru Host-ul cererii sau tokenul CSRF este invalid pentru sesiunea legată de host." }, "Forbidden": { "description": "The authenticated identity lacks the administrator permission.", "x-docula-problem-code": "forbidden", "x-docula-problem-status": 403, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 403 }, "code": { "const": "forbidden" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic Forbidden response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 403, "code": "forbidden", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Identitatea autentificată nu are permisiunea de administrator." }, "Conflict": { "description": "The resource changed before the requested mutation could be applied.", "x-docula-problem-code": "conflict", "x-docula-problem-status": 409, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 409 }, "code": { "const": "conflict" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic Conflict response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 409, "code": "conflict", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Resursa s-a schimbat înainte ca mutația solicitată să poată fi aplicată." }, "ContentUnavailable": { "description": "The owned element exists, but no authorized JSON content is available for its current or permanent state.", "x-docula-problem-code": "content_unavailable", "x-docula-problem-status": 409, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 409 }, "code": { "const": "content_unavailable" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic ContentUnavailable response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 409, "code": "content_unavailable", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Elementul deținut există, dar nu este disponibil conținut JSON autorizat pentru starea sa curentă sau permanentă." }, "PreconditionFailed": { "description": "The supplied revision does not match the current draft.", "x-docula-problem-code": "precondition_failed", "x-docula-problem-status": 412, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 412 }, "code": { "const": "precondition_failed" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic PreconditionFailed response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 412, "code": "precondition_failed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Revizia furnizată nu corespunde ciornei curente." }, "PreconditionRequired": { "description": "A current strong If-Match revision is required.", "x-docula-problem-code": "precondition_required", "x-docula-problem-status": 428, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 428 }, "code": { "const": "precondition_required" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic PreconditionRequired response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 428, "code": "precondition_required", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Este necesară o revizie puternică If-Match curentă." }, "NotFound": { "description": "The API or health path is unknown.", "x-docula-problem-code": "not_found", "x-docula-problem-status": 404, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 404 }, "code": { "const": "not_found" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic NotFound response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 404, "code": "not_found", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Calea API sau de health este necunoscută." }, "MethodNotAllowed": { "description": "The method is not supported by this path.", "x-docula-problem-code": "method_not_allowed", "x-docula-problem-status": 405, "headers": { "Allow": { "required": true, "description": "The exact method or method set supported by this path.", "schema": { "type": "string", "enum": [ "GET", "POST", "GET, POST", "GET, PUT" ] }, "x-docula-description-ro": "Metoda sau setul exact de metode acceptate de această cale." } }, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 405 }, "code": { "const": "method_not_allowed" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic MethodNotAllowed response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 405, "code": "method_not_allowed", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Metoda nu este acceptată de această cale." }, "UnsupportedMediaType": { "description": "The mutation is missing the exact supported JSON content type.", "x-docula-problem-code": "unsupported_media_type", "x-docula-problem-status": 415, "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/Problem" }, { "type": "object", "properties": { "status": { "const": 415 }, "code": { "const": "unsupported_media_type" } } } ] }, "examples": { "synthetic": { "summary": "Synthetic UnsupportedMediaType response", "value": { "type": "/problems/synthetic_example", "title": "synthetic-example", "status": 415, "code": "unsupported_media_type", "detail": "synthetic-example", "correlation_id": "11111111-1111-4111-8111-000000000001" } } } } }, "x-docula-description-ro": "Mutației îi lipsește tipul de conținut JSON acceptat exact." } } }, "tags": [ { "name": "Health", "description": "Process and dependency health with bounded public and administrator detail." }, { "name": "Authentication", "description": "Host-local session, password, and logout operations." }, { "name": "Administration", "description": "Administrator-only runtime and identity operations." }, { "name": "Contracts", "description": "Mutable contract drafts and immutable contract versions." }, { "name": "Cases", "description": "Deterministic cases and their immutable provenance." }, { "name": "Ingestion models", "description": "Calendar-effective ingestion-model definitions and activations." }, { "name": "Transformers", "description": "Declarative transformer definitions, tests, versions, and activations." }, { "name": "Templates", "description": "Verified DOCX templates, previews, versions, and activations." }, { "name": "Releases", "description": "Immutable processing and document release manifests." }, { "name": "Configuration deployments", "description": "Validated and atomic correlated configuration deployment." }, { "name": "Executions", "description": "Durable execution submission, trace, and artifact retrieval." }, { "name": "Submissions", "description": "External submissions and complete processing/storage evidence." }, { "name": "Analytics", "description": "Canonical business and processing aggregates and contributors." }, { "name": "Storage", "description": "Canonical artifact projections and authorized retrieval." }, { "name": "RCA demo", "description": "Bounded synthetic RCA and intake-test-lab scenarios." }, { "name": "Audit", "description": "Append-only audit evidence." } ] }