{ "openapi": "3.1.0", "info": { "title": "Trusted LTANS — Target REST Contracts", "version": "3.0.0-draft", "description": "Trusted LTANS target design. Draft 3 separates export, transfer, hold, audit and usage resources and binds transfer acknowledgements to package scope. No deployed backend or cryptographic conformance asserted." }, "servers": [ { "url": "https://api.example.invalid", "description": "Non-routable example; offline explorer uses local simulation only." } ], "tags": [ { "name": "Archive", "description": "Target Archive API" }, { "name": "Evidence", "description": "Target Evidence API" }, { "name": "Verification", "description": "Target Verification API" }, { "name": "Renewal", "description": "Target Renewal API" }, { "name": "Policy", "description": "Target Policy API" }, { "name": "Export", "description": "Target Export API" }, { "name": "Transfer", "description": "Target Transfer API" }, { "name": "Job", "description": "Target Job API" }, { "name": "Webhook", "description": "Target Webhook API" }, { "name": "Audit", "description": "Target Audit API" } ], "paths": { "/v1/archives": { "post": { "operationId": "archive1", "summary": "POST /v1/archives", "description": "Target Archive operation. Reuse the original key only for an identical retry; inspect the existing result before starting a new command. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Archive" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "202": { "description": "Accepted asynchronous work; poll jobId until terminal state.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Acknowledgement" }, "example": { "archiveId": "arc-test-001", "jobId": "job-test-001", "policyId": "policy-test-v1", "policyVersion": "1", "receivedAt": "2026-10-15T05:00:01Z", "state": "ACCEPTED" } } }, "links": { "JobStatus": { "operationId": "job19", "parameters": { "jobId": "$response.body#/jobId" }, "description": "Poll the accepted job to a terminal state." } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Idempotency key conflicts with another payload. Reuse the original key only for an identical retry; inspect the existing result before starting a new command.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/archive-key-conflict", "title": "Archive Key Conflict", "code": "ARCHIVE_KEY_CONFLICT", "detail": "Idempotency key conflicts with another payload.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "archives:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "ArchiveRequest", "x-event": "ArchiveRequested", "x-state-transition": "QUEUED → RUNNING → SUCCEEDED / FAILED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveRequest" }, "example": { "profileId": "profile-test-01", "policyId": "policy-test-v1", "mimeType": "text/plain", "metadata": { "title": "LTANS-SYN-001 / r1", "sourceId": "LTANS-SYN-001", "sourceRevision": "r1" }, "custody": "CUSTOMER_MANAGED", "dataReference": "https://storage.example.invalid/test/primary-record.txt", "digest": { "algorithm": "SHA-256", "value": "35bc4fcffc4a16c8a9db81d1a8f9042c27a1daaf51628b4c880f312178fe3085" }, "archivalPeriod": { "endAt": "2036-10-15T00:00:00Z" }, "clientReference": "LTANS-SYN-001/r1", "requestTime": "2026-10-15T05:00:00Z", "groupId": "grp-syn-001" } } } }, "x-error-recovery": "Reuse the original key only for an identical retry; inspect the existing result before starting a new command." }, "get": { "operationId": "archive2", "summary": "GET /v1/archives", "description": "Target Archive operation. Reuse the original key only for an identical retry; inspect the existing result before starting a new command. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Archive" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "$ref": "#/components/parameters/Cursor" }, { "$ref": "#/components/parameters/Limit" }, { "name": "clientReference", "in": "query", "schema": { "type": "string" } }, { "name": "groupId", "in": "query", "schema": { "type": "string" } }, { "name": "state", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveList" }, "example": { "items": [ { "archiveId": "arc-test-001", "profileId": "profile-test-01", "policyId": "policy-test-v1", "custody": "CUSTOMER_MANAGED", "mimeType": "application/pdf", "metadata": { "title": "Synthetic record" }, "state": "EVIDENCE_READY", "evidenceVersion": 1 } ] } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Idempotency key conflicts with another payload. Reuse the original key only for an identical retry; inspect the existing result before starting a new command.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/archive-key-conflict", "title": "Archive Key Conflict", "code": "ARCHIVE_KEY_CONFLICT", "detail": "Idempotency key conflicts with another payload.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "archives:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "ArchiveList", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Reuse the original key only for an identical retry; inspect the existing result before starting a new command." } }, "/v1/archives/{archiveId}": { "get": { "operationId": "archive3", "summary": "GET /v1/archives/{archiveId}", "description": "Target Archive operation. Reuse the original key only for an identical retry; inspect the existing result before starting a new command. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Archive" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveObject" }, "example": { "archiveId": "arc-test-001", "profileId": "profile-test-01", "policyId": "policy-test-v1", "custody": "CUSTOMER_MANAGED", "mimeType": "application/pdf", "metadata": { "title": "Synthetic record" }, "state": "EVIDENCE_READY", "evidenceVersion": 1 } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Idempotency key conflicts with another payload. Reuse the original key only for an identical retry; inspect the existing result before starting a new command.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/archive-key-conflict", "title": "Archive Key Conflict", "code": "ARCHIVE_KEY_CONFLICT", "detail": "Idempotency key conflicts with another payload.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "archives:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "ArchiveObject", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Reuse the original key only for an identical retry; inspect the existing result before starting a new command." } }, "/v1/archives/{archiveId}/status": { "get": { "operationId": "archive4", "summary": "GET /v1/archives/{archiveId}/status", "description": "Target Archive operation. Reuse the original key only for an identical retry; inspect the existing result before starting a new command. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Archive" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveObject" }, "example": { "archiveId": "arc-test-001", "profileId": "profile-test-01", "policyId": "policy-test-v1", "custody": "CUSTOMER_MANAGED", "mimeType": "application/pdf", "metadata": { "title": "Synthetic record" }, "state": "EVIDENCE_READY", "evidenceVersion": 1 } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Idempotency key conflicts with another payload. Reuse the original key only for an identical retry; inspect the existing result before starting a new command.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/archive-key-conflict", "title": "Archive Key Conflict", "code": "ARCHIVE_KEY_CONFLICT", "detail": "Idempotency key conflicts with another payload.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "archives:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "ArchiveObject", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Reuse the original key only for an identical retry; inspect the existing result before starting a new command." } }, "/v1/archives/{archiveId}/evidence": { "get": { "operationId": "evidence5", "summary": "GET /v1/archives/{archiveId}/evidence", "description": "Target Evidence operation. Poll the existing generation job; do not create a duplicate archive. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Evidence" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceRecord" }, "example": { "archiveId": "arc-test-001", "version": 1, "syntax": "ASN1_ERS", "mediaType": "application/octet-stream", "downloadReference": "/v1/downloads/evidence-test-001", "digest": { "algorithm": "SHA-256", "value": "0000000000000000000000000000000000000000000000000000000000000000" }, "policyHistory": [ "policy-test-v1" ] } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "The evidence version is not ready. Poll the existing generation job; do not create a duplicate archive.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/evidence-not-ready", "title": "Evidence Not Ready", "code": "EVIDENCE_NOT_READY", "detail": "The evidence version is not ready.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Evidence Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "evidence:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Evidence Service", "x-business-object": "EvidenceRecord", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Poll the existing generation job; do not create a duplicate archive." } }, "/v1/archives/{archiveId}/evidence/{evidenceVersion}": { "get": { "operationId": "evidence6", "summary": "GET /v1/archives/{archiveId}/evidence/{evidenceVersion}", "description": "Target Evidence operation. Poll the existing generation job; do not create a duplicate archive. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Evidence" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "evidenceVersion", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceRecord" }, "example": { "archiveId": "arc-test-001", "version": 1, "syntax": "ASN1_ERS", "mediaType": "application/octet-stream", "downloadReference": "/v1/downloads/evidence-test-001", "digest": { "algorithm": "SHA-256", "value": "0000000000000000000000000000000000000000000000000000000000000000" }, "policyHistory": [ "policy-test-v1" ] } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "The evidence version is not ready. Poll the existing generation job; do not create a duplicate archive.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/evidence-not-ready", "title": "Evidence Not Ready", "code": "EVIDENCE_NOT_READY", "detail": "The evidence version is not ready.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Evidence Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "evidence:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Evidence Service", "x-business-object": "EvidenceRecord", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Poll the existing generation job; do not create a duplicate archive." } }, "/v1/archives/{archiveId}/verification": { "post": { "operationId": "verification7", "summary": "POST /v1/archives/{archiveId}/verification", "description": "Target Verification operation. Select an authorized versioned context; INDETERMINATE is a report outcome, not a transport failure. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Verification" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "202": { "description": "Accepted asynchronous work; poll jobId until terminal state.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" }, "example": { "jobId": "job-verification-001", "state": "QUEUED", "resourceId": "ver-test-001", "correlationId": "corr-test-001", "pollAfterSeconds": 2 } } }, "links": { "JobStatus": { "operationId": "job19", "parameters": { "jobId": "$response.body#/jobId" }, "description": "Poll the accepted job to a terminal state." } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "The requested trust context is unavailable. Select an authorized versioned context; INDETERMINATE is a report outcome, not a transport failure.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/trust-context-unavailable", "title": "Trust Context Unavailable", "code": "TRUST_CONTEXT_UNAVAILABLE", "detail": "The requested trust context is unavailable.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Verification Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "verification:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Verification Service", "x-business-object": "VerificationRequest", "x-event": "VerificationRequested", "x-state-transition": "QUEUED → RUNNING → SUCCEEDED / FAILED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerificationRequest" }, "example": { "evidenceVersion": 1, "trustContextId": "trust-test-001", "dataReference": "https://storage.example.invalid/test/object-001" } } } }, "x-error-recovery": "Select an authorized versioned context; INDETERMINATE is a report outcome, not a transport failure." } }, "/v1/verifications/{verificationId}": { "get": { "operationId": "verification8", "summary": "GET /v1/verifications/{verificationId}", "description": "Target Verification operation. Select an authorized versioned context; INDETERMINATE is a report outcome, not a transport failure. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Verification" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "verificationId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerificationReport" }, "example": { "verificationId": "ver-test-001", "archiveId": "arc-test-001", "outcome": "INDETERMINATE", "evaluatedAt": "2026-10-15T05:00:00Z", "trustContextId": "trust-test-001", "policyId": "policy-test-v1", "policyVersion": "1", "toolVersion": "target-validator-1", "evidenceVersion": 1, "reasonCodes": [ "TEST_TRUST_MATERIAL_NOT_SUPPLIED" ], "steps": [ { "check": "timestamp-path", "outcome": "INDETERMINATE", "reasonCode": "TEST_TRUST_MATERIAL_NOT_SUPPLIED", "detail": "Synthetic response: no trusted TSA token is bundled." } ] } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "The requested trust context is unavailable. Select an authorized versioned context; INDETERMINATE is a report outcome, not a transport failure.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/trust-context-unavailable", "title": "Trust Context Unavailable", "code": "TRUST_CONTEXT_UNAVAILABLE", "detail": "The requested trust context is unavailable.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Verification Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "verification:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Verification Service", "x-business-object": "VerificationReport", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Select an authorized versioned context; INDETERMINATE is a report outcome, not a transport failure." } }, "/v1/renewals": { "post": { "operationId": "renewal9", "summary": "POST /v1/renewals", "description": "Target Renewal operation. Restore owner-approved access before hash-tree renewal. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Renewal" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "202": { "description": "Accepted asynchronous work; poll jobId until terminal state.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Renewal" }, "example": { "renewalId": "ren-test-001", "archiveId": "arc-test-001", "jobId": "job-test-002", "mode": "HASH_TREE", "state": "APPROVED" } } }, "links": { "JobStatus": { "operationId": "job19", "parameters": { "jobId": "$response.body#/jobId" }, "description": "Poll the accepted job to a terminal state." } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Original bytes cannot be read. Restore owner-approved access before hash-tree renewal.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/renew-data-unavailable", "title": "Renew Data Unavailable", "code": "RENEW_DATA_UNAVAILABLE", "detail": "Original bytes cannot be read.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Renewal Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "renewals:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Renewal Service", "x-business-object": "RenewalRequest", "x-event": "RenewalStarted", "x-state-transition": "QUEUED → RUNNING → SUCCEEDED / FAILED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RenewalRequest" }, "example": { "archiveId": "arc-test-001", "evidenceVersion": 1, "mode": "HASH_TREE", "dataReference": "https://storage.example.invalid/test/object-001", "approvalId": "approval-test-001", "reason": "Scheduled synthetic test" } } } }, "x-error-recovery": "Restore owner-approved access before hash-tree renewal." } }, "/v1/renewals/{renewalId}": { "get": { "operationId": "renewal10", "summary": "GET /v1/renewals/{renewalId}", "description": "Target Renewal operation. Restore owner-approved access before hash-tree renewal. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Renewal" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "renewalId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Renewal" }, "example": { "renewalId": "ren-test-001", "archiveId": "arc-test-001", "jobId": "job-test-002", "mode": "HASH_TREE", "state": "APPROVED" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Original bytes cannot be read. Restore owner-approved access before hash-tree renewal.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/renew-data-unavailable", "title": "Renew Data Unavailable", "code": "RENEW_DATA_UNAVAILABLE", "detail": "Original bytes cannot be read.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Renewal Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "renewals:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Renewal Service", "x-business-object": "Renewal", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Restore owner-approved access before hash-tree renewal." } }, "/v1/profiles": { "get": { "operationId": "policy11", "summary": "GET /v1/profiles", "description": "Target Policy operation. Select an effective permitted revision; do not rewrite the historical policy snapshot. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Policy" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "$ref": "#/components/parameters/Cursor" }, { "$ref": "#/components/parameters/Limit" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProfileList" }, "example": { "items": [ { "profileId": "profile-test-01", "policyId": "policy-test-v1", "version": "1", "syntax": "ASN1_ERS", "tsaProfileId": "tsa-test-001", "status": "EFFECTIVE" } ] } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "Policy or profile has no effective release. Select an effective permitted revision; do not rewrite the historical policy snapshot.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/policy-not-effective", "title": "Policy Not Effective", "code": "POLICY_NOT_EFFECTIVE", "detail": "Policy or profile has no effective release.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Policy Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "policies:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Policy Service", "x-business-object": "ProfileList", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Select an effective permitted revision; do not rewrite the historical policy snapshot." } }, "/v1/profiles/{profileId}": { "get": { "operationId": "policy12", "summary": "GET /v1/profiles/{profileId}", "description": "Target Policy operation. Select an effective permitted revision; do not rewrite the historical policy snapshot. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Policy" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "profileId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Profile" }, "example": { "profileId": "profile-test-01", "policyId": "policy-test-v1", "version": "1", "syntax": "ASN1_ERS", "tsaProfileId": "tsa-test-001", "status": "EFFECTIVE" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "Policy or profile has no effective release. Select an effective permitted revision; do not rewrite the historical policy snapshot.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/policy-not-effective", "title": "Policy Not Effective", "code": "POLICY_NOT_EFFECTIVE", "detail": "Policy or profile has no effective release.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Policy Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "policies:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Policy Service", "x-business-object": "Profile", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Select an effective permitted revision; do not rewrite the historical policy snapshot." } }, "/v1/policies/{policyId}": { "get": { "operationId": "policy13", "summary": "GET /v1/policies/{policyId}", "description": "Target Policy operation. Select an effective permitted revision; do not rewrite the historical policy snapshot. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Policy" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "policyId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Policy" }, "example": { "policyId": "policy-test-v1", "version": "1", "retentionRule": "Synthetic 10-year test rule, not a legal requirement", "renewalRule": "Scheduled risk review", "dispositionRule": "Approval and no active hold", "releaseId": "synthetic-release-001", "status": "EFFECTIVE" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "Policy or profile has no effective release. Select an effective permitted revision; do not rewrite the historical policy snapshot.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/policy-not-effective", "title": "Policy Not Effective", "code": "POLICY_NOT_EFFECTIVE", "detail": "Policy or profile has no effective release.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Policy Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "policies:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Policy Service", "x-business-object": "Policy", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Select an effective permitted revision; do not rewrite the historical policy snapshot." } }, "/v1/archives/{archiveId}/exports": { "post": { "operationId": "export14", "summary": "POST /v1/archives/{archiveId}/exports", "description": "Target Export operation. Obtain recipient and payload export authorization. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Export" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "202": { "description": "Accepted asynchronous work; poll jobId until terminal state.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" }, "example": { "jobId": "job-export-001", "state": "QUEUED", "resourceId": "exp-test-001", "correlationId": "corr-test-001", "pollAfterSeconds": 2 } } }, "links": { "JobStatus": { "operationId": "job19", "parameters": { "jobId": "$response.body#/jobId" }, "description": "Poll the accepted job to a terminal state." } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "description": "Requested export scope is not permitted. Obtain recipient and payload export authorization.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/export-scope-denied", "title": "Export Scope Denied", "code": "EXPORT_SCOPE_DENIED", "detail": "Requested export scope is not permitted.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 403, "instance": "urn:ltans:request:req-test-001" } } } }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "exports:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "ExportRequest", "x-event": "ExportRequested", "x-state-transition": "QUEUED → RUNNING → SUCCEEDED / FAILED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportRequest" }, "example": { "evidenceVersion": 1, "includePayload": true, "recipientKeyId": "recipient-test-001" } } } }, "x-error-recovery": "Obtain recipient and payload export authorization." } }, "/v1/exports/{exportId}": { "get": { "operationId": "export15", "summary": "GET /v1/exports/{exportId}", "description": "Target Export operation. Obtain recipient and payload export authorization. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Export" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "exportId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExportResult" }, "example": { "exportId": "exp-test-001", "archiveId": "arc-test-001", "state": "EXPORTED", "jobId": "job-export-001", "manifestReference": "/assigned-channel/exp-test-001/manifest.json", "packageDigest": { "algorithm": "SHA-256", "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1" } } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "description": "Requested export scope is not permitted. Obtain recipient and payload export authorization.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/export-scope-denied", "title": "Export Scope Denied", "code": "EXPORT_SCOPE_DENIED", "detail": "Requested export scope is not permitted.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 403, "instance": "urn:ltans:request:req-test-001" } } } }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "exports:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "ResourceResult", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Obtain recipient and payload export authorization." } }, "/v1/archives/{archiveId}/transfers": { "post": { "operationId": "transfer16", "summary": "POST /v1/archives/{archiveId}/transfers", "description": "Target Transfer operation. Keep source custody; verify manifest and recipient acknowledgement. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Transfer" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "202": { "description": "Accepted asynchronous work; poll jobId until terminal state.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" }, "example": { "jobId": "job-transfer-001", "state": "QUEUED", "resourceId": "trf-test-001", "correlationId": "corr-test-001", "pollAfterSeconds": 2 } } }, "links": { "JobStatus": { "operationId": "job19", "parameters": { "jobId": "$response.body#/jobId" }, "description": "Poll the accepted job to a terminal state." } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Recipient verification has not been acknowledged. Keep source custody; verify manifest and recipient acknowledgement.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/transfer-not-acknowledged", "title": "Transfer Not Acknowledged", "code": "TRANSFER_NOT_ACKNOWLEDGED", "detail": "Recipient verification has not been acknowledged.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "transfers:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "TransferRequest", "x-event": "TransferStarted", "x-state-transition": "QUEUED → RUNNING → SUCCEEDED / FAILED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferRequest" }, "example": { "exportId": "exp-test-001", "destinationProfileId": "destination-test-001", "approvalId": "approval-test-002" } } } }, "x-error-recovery": "Keep source custody; verify manifest and recipient acknowledgement." } }, "/v1/transfers/{transferId}": { "get": { "operationId": "transfer17", "summary": "GET /v1/transfers/{transferId}", "description": "Target Transfer operation. Keep source custody; verify manifest and recipient acknowledgement. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Transfer" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "transferId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferResult" }, "example": { "transferId": "trf-test-001", "archiveId": "arc-test-001", "exportId": "exp-test-001", "recipientId": "recipient-test-001", "state": "AWAITING_ACKNOWLEDGEMENT", "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example", "jobId": "job-transfer-001", "packageDigest": { "algorithm": "SHA-256", "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1" } } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Recipient verification has not been acknowledged. Keep source custody; verify manifest and recipient acknowledgement.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/transfer-not-acknowledged", "title": "Transfer Not Acknowledged", "code": "TRANSFER_NOT_ACKNOWLEDGED", "detail": "Recipient verification has not been acknowledged.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "transfers:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "ResourceResult", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Keep source custody; verify manifest and recipient acknowledgement." } }, "/v1/transfers/{transferId}/acknowledgements": { "post": { "operationId": "transfer18", "summary": "POST /v1/transfers/{transferId}/acknowledgements", "description": "Authorize the authenticated recipient; bind path transferId, exportId, package digest, report and scope. Persist acknowledgement once under the idempotency key. Acknowledgement does not authorize source deletion.", "tags": [ "Transfer" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "transferId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferResult" }, "example": { "transferId": "trf-test-001", "archiveId": "arc-test-001", "exportId": "exp-test-001", "recipientId": "recipient-test-001", "state": "ACKNOWLEDGED", "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example", "jobId": "job-transfer-001", "packageDigest": { "algorithm": "SHA-256", "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1" }, "acknowledgementId": "ack-test-001", "acceptedAt": "2026-10-15T09:00:00Z" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Recipient verification has not been acknowledged. Keep source custody; verify manifest and recipient acknowledgement.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/transfer-not-acknowledged", "title": "Transfer Not Acknowledged", "code": "TRANSFER_NOT_ACKNOWLEDGED", "detail": "Recipient verification has not been acknowledged.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "transfers:acknowledge" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "Digest", "x-event": "TransferCompleted", "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransferAcknowledgement" }, "example": { "transferId": "trf-test-001", "exportId": "exp-test-001", "recipientId": "recipient-test-001", "packageDigest": { "algorithm": "SHA-256", "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1" }, "verificationReportReference": "urn:ltans:synthetic:recipient-report-001", "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example", "acceptedAt": "2026-10-15T09:00:00Z" } } } }, "x-error-recovery": "Keep source custody; verify manifest and recipient acknowledgement." } }, "/v1/jobs/{jobId}": { "get": { "operationId": "job19", "summary": "GET /v1/jobs/{jobId}", "description": "Target Job operation. Check saved jobId and tenant; never assume timeout means failure. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Job" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "jobId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" }, "example": { "jobId": "job-transfer-001", "state": "SUCCEEDED", "resourceId": "trf-test-001", "correlationId": "corr-test-001", "pollAfterSeconds": 2, "resultReference": "/v1/transfers/trf-test-001" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "description": "Job is not visible in the current tenant. Check saved jobId and tenant; never assume timeout means failure.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/job-not-found", "title": "Job Not Found", "code": "JOB_NOT_FOUND", "detail": "Job is not visible in the current tenant.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Archive Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 404, "instance": "urn:ltans:request:req-test-001" } } } }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "jobs:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Archive Service", "x-business-object": "Job", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Check saved jobId and tenant; never assume timeout means failure." } }, "/v1/webhooks": { "post": { "operationId": "webhook20", "summary": "POST /v1/webhooks", "description": "Target Webhook operation. Use an allow-listed HTTPS receiver and complete endpoint ownership verification. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Webhook" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" }, "example": { "webhookId": "wh-test-001", "endpoint": "https://receiver.example.invalid/events", "events": [ "EvidenceGenerated" ], "signingKeyId": "key-test-001", "state": "PENDING_VERIFICATION" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "Endpoint cannot pass the destination policy. Use an allow-listed HTTPS receiver and complete endpoint ownership verification.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/webhook-endpoint-rejected", "title": "Webhook Endpoint Rejected", "code": "WEBHOOK_ENDPOINT_REJECTED", "detail": "Endpoint cannot pass the destination policy.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Webhook Delivery Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "webhooks:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Webhook Delivery Service", "x-business-object": "Webhook", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" }, "example": { "webhookId": "wh-test-001", "endpoint": "https://receiver.example.invalid/events", "events": [ "EvidenceGenerated" ], "signingKeyId": "key-test-001", "state": "PENDING_VERIFICATION" } } } }, "x-error-recovery": "Use an allow-listed HTTPS receiver and complete endpoint ownership verification." } }, "/v1/webhooks/{webhookId}": { "get": { "operationId": "webhook21", "summary": "GET /v1/webhooks/{webhookId}", "description": "Target Webhook operation. Use an allow-listed HTTPS receiver and complete endpoint ownership verification. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Webhook" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "webhookId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhook" }, "example": { "webhookId": "wh-test-001", "endpoint": "https://receiver.example.invalid/events", "events": [ "EvidenceGenerated" ], "signingKeyId": "key-test-001", "state": "PENDING_VERIFICATION" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "Endpoint cannot pass the destination policy. Use an allow-listed HTTPS receiver and complete endpoint ownership verification.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/webhook-endpoint-rejected", "title": "Webhook Endpoint Rejected", "code": "WEBHOOK_ENDPOINT_REJECTED", "detail": "Endpoint cannot pass the destination policy.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Webhook Delivery Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "webhooks:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Webhook Delivery Service", "x-business-object": "Webhook", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Use an allow-listed HTTPS receiver and complete endpoint ownership verification." }, "delete": { "operationId": "webhook22", "summary": "DELETE /v1/webhooks/{webhookId}", "description": "Target Webhook operation. Use an allow-listed HTTPS receiver and complete endpoint ownership verification. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Webhook" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "webhookId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "204": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "Endpoint cannot pass the destination policy. Use an allow-listed HTTPS receiver and complete endpoint ownership verification.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/webhook-endpoint-rejected", "title": "Webhook Endpoint Rejected", "code": "WEBHOOK_ENDPOINT_REJECTED", "detail": "Endpoint cannot pass the destination policy.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Webhook Delivery Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "webhooks:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Webhook Delivery Service", "x-business-object": null, "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Use an allow-listed HTTPS receiver and complete endpoint ownership verification." } }, "/v1/archives/{archiveId}/holds": { "post": { "operationId": "policy23", "summary": "POST /v1/archives/{archiveId}/holds", "description": "Target Policy operation. Select an effective permitted revision; do not rewrite the historical policy snapshot. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Policy" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldResult" }, "example": { "holdId": "hold-test-001", "archiveId": "arc-test-001", "state": "ACTIVE", "caseId": "case-test-001" } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "description": "Policy or profile has no effective release. Select an effective permitted revision; do not rewrite the historical policy snapshot.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/policy-not-effective", "title": "Policy Not Effective", "code": "POLICY_NOT_EFFECTIVE", "detail": "Policy or profile has no effective release.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Policy Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "holds:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Policy Service", "x-business-object": "HoldRequest", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HoldRequest" }, "example": { "caseId": "case-test-001", "reason": "Synthetic hold test", "approvalId": "approval-test-003" } } } }, "x-error-recovery": "Select an effective permitted revision; do not rewrite the historical policy snapshot." } }, "/v1/archives/{archiveId}/dispositions": { "post": { "operationId": "archive24", "summary": "POST /v1/archives/{archiveId}/dispositions", "description": "Target Archive operation. Reuse the original key only for an identical retry; inspect the existing result before starting a new command. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Archive" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "name": "archiveId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "202": { "description": "Accepted asynchronous work; poll jobId until terminal state.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" }, "example": { "jobId": "job-disposition-001", "state": "QUEUED", "resourceId": "arc-test-001", "correlationId": "corr-test-001", "pollAfterSeconds": 2 } } }, "links": { "JobStatus": { "operationId": "job19", "parameters": { "jobId": "$response.body#/jobId" }, "description": "Poll the accepted job to a terminal state." } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "$ref": "#/components/responses/Problem" }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "description": "Idempotency key conflicts with another payload. Reuse the original key only for an identical retry; inspect the existing result before starting a new command.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/archive-key-conflict", "title": "Archive Key Conflict", "code": "ARCHIVE_KEY_CONFLICT", "detail": "Idempotency key conflicts with another payload.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Storage Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 409, "instance": "urn:ltans:request:req-test-001" } } } }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "disposition:write" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Storage Service", "x-business-object": "DispositionRequest", "x-event": "DispositionRequested", "x-state-transition": "QUEUED → RUNNING → SUCCEEDED / FAILED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DispositionRequest" }, "example": { "scope": "PAYLOAD", "approvalId": "approval-test-004", "reason": "Synthetic expiry test" } } } }, "x-error-recovery": "Reuse the original key only for an identical retry; inspect the existing result before starting a new command." } }, "/v1/audit-records": { "get": { "operationId": "audit25", "summary": "GET /v1/audit-records", "description": "Target Audit operation. Restrict tenant, period and query to the granted reporting scope. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Audit" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "$ref": "#/components/parameters/Cursor" }, { "$ref": "#/components/parameters/Limit" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditList" }, "example": { "items": [ { "auditRecordId": "aud-test-001", "resourceType": "Transfer", "resourceId": "trf-test-001", "action": "TRANSFER_ACKNOWLEDGED", "actorId": "recipient-test-001", "occurredAt": "2026-10-15T09:00:00Z", "correlationId": "corr-test-001" } ] } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "description": "Report scope exceeds granted permissions. Restrict tenant, period and query to the granted reporting scope.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/report-scope-denied", "title": "Report Scope Denied", "code": "REPORT_SCOPE_DENIED", "detail": "Report scope exceeds granted permissions.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Audit & Reporting", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 403, "instance": "urn:ltans:request:req-test-001" } } } }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "audit:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Audit & Reporting", "x-business-object": "AuditList", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Restrict tenant, period and query to the granted reporting scope." } }, "/v1/usage-reports": { "get": { "operationId": "audit26", "summary": "GET /v1/usage-reports", "description": "Target Audit operation. Restrict tenant, period and query to the granted reporting scope. Tenant/object authorization remains mandatory. Backend behavior is not verified by this static package.", "tags": [ "Audit" ], "parameters": [ { "$ref": "#/components/parameters/CorrelationId" }, { "$ref": "#/components/parameters/Cursor" }, { "$ref": "#/components/parameters/Limit" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "X-Correlation-ID": { "schema": { "type": "string" }, "description": "Request correlation context" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageList" }, "example": { "items": [ { "usageRecordId": "usage-test-001", "periodStart": "2026-10-01T00:00:00Z", "periodEnd": "2026-11-01T00:00:00Z", "metric": "acceptedObjects", "quantity": 1, "unit": "object", "sourceReference": "/v1/archives/arc-test-001" } ] } } } }, "400": { "$ref": "#/components/responses/Problem" }, "401": { "$ref": "#/components/responses/Problem" }, "403": { "description": "Report scope exceeds granted permissions. Restrict tenant, period and query to the granted reporting scope.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/report-scope-denied", "title": "Report Scope Denied", "code": "REPORT_SCOPE_DENIED", "detail": "Report scope exceeds granted permissions.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Audit & Reporting", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 403, "instance": "urn:ltans:request:req-test-001" } } } }, "404": { "$ref": "#/components/responses/Problem" }, "409": { "$ref": "#/components/responses/Problem" }, "422": { "$ref": "#/components/responses/Problem" }, "429": { "$ref": "#/components/responses/Problem" }, "503": { "$ref": "#/components/responses/Problem" } }, "security": [ { "OAuth2": [ "billing:read" ] } ], "x-classification": "TARGET_API_CONTRACT", "x-owning-service": "Audit & Reporting", "x-business-object": "UsageList", "x-event": null, "x-state-transition": "AUTHORIZED → COMPLETED", "x-mtls": "Required when agreed deployment profile mandates client certificate authentication.", "x-error-recovery": "Restrict tenant, period and query to the granted reporting scope." } } }, "components": { "schemas": { "ArchiveRequest": { "type": "object", "properties": { "profileId": { "type": "string" }, "policyId": { "type": "string" }, "mimeType": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "custody": { "type": "string", "enum": [ "PROVIDER_MANAGED", "CUSTOMER_MANAGED", "HASH_ONLY" ] }, "dataReference": { "type": "string", "format": "uri", "description": "Allow-listed object reference; arbitrary server-side URL fetching is forbidden." }, "digest": { "$ref": "#/components/schemas/Digest" }, "archivalPeriod": { "$ref": "#/components/schemas/ArchivalPeriod" }, "groupId": { "type": "string" }, "clientReference": { "type": "string" }, "requestTime": { "type": "string", "format": "date-time" }, "uploadId": { "type": "string", "minLength": 1, "description": "Identifier of a completed upload in an agreed storage connector; upload transport is outside these REST contracts." }, "externalObjectId": { "type": "string", "minLength": 1, "description": "Owner-retained data identifier for hash-only preservation; not an automatic fetch URL." } }, "required": [ "profileId", "policyId", "mimeType", "custody", "digest", "archivalPeriod" ], "additionalProperties": false, "allOf": [ { "if": { "properties": { "custody": { "const": "PROVIDER_MANAGED" } }, "required": [ "custody" ] }, "then": { "required": [ "uploadId" ], "not": { "anyOf": [ { "required": [ "dataReference" ] }, { "required": [ "externalObjectId" ] } ] } } }, { "if": { "properties": { "custody": { "const": "CUSTOMER_MANAGED" } }, "required": [ "custody" ] }, "then": { "required": [ "dataReference" ], "not": { "anyOf": [ { "required": [ "uploadId" ] }, { "required": [ "externalObjectId" ] } ] } } }, { "if": { "properties": { "custody": { "const": "HASH_ONLY" } }, "required": [ "custody" ] }, "then": { "required": [ "externalObjectId" ], "not": { "anyOf": [ { "required": [ "dataReference" ] }, { "required": [ "uploadId" ] } ] } } } ], "examples": [ { "profileId": "profile-test-01", "policyId": "policy-test-v1", "mimeType": "text/plain", "metadata": { "title": "LTANS-SYN-001 / r1", "sourceId": "LTANS-SYN-001", "sourceRevision": "r1" }, "custody": "CUSTOMER_MANAGED", "dataReference": "https://storage.example.invalid/test/primary-record.txt", "digest": { "algorithm": "SHA-256", "value": "35bc4fcffc4a16c8a9db81d1a8f9042c27a1daaf51628b4c880f312178fe3085" }, "archivalPeriod": { "endAt": "2036-10-15T00:00:00Z" }, "clientReference": "LTANS-SYN-001/r1", "requestTime": "2026-10-15T05:00:00Z", "groupId": "grp-syn-001" } ] }, "Digest": { "type": "object", "properties": { "algorithm": { "type": "string", "enum": [ "SHA-256", "SHA-384", "SHA-512" ] }, "value": { "type": "string", "pattern": "^[a-fA-F0-9]+$" } }, "required": [ "algorithm", "value" ], "additionalProperties": false, "allOf": [ { "if": { "properties": { "algorithm": { "const": "SHA-256" } }, "required": [ "algorithm" ] }, "then": { "properties": { "value": { "minLength": 64, "maxLength": 64 } } } }, { "if": { "properties": { "algorithm": { "const": "SHA-384" } }, "required": [ "algorithm" ] }, "then": { "properties": { "value": { "minLength": 96, "maxLength": 96 } } } }, { "if": { "properties": { "algorithm": { "const": "SHA-512" } }, "required": [ "algorithm" ] }, "then": { "properties": { "value": { "minLength": 128, "maxLength": 128 } } } } ], "examples": [ { "algorithm": "SHA-256", "value": "0000000000000000000000000000000000000000000000000000000000000000" } ] }, "ArchivalPeriod": { "type": "object", "properties": { "endAt": { "type": "string", "format": "date-time" }, "triggerEvent": { "type": "string" }, "durationAfterTrigger": { "type": "string", "pattern": "^P[1-9][0-9]*D$", "description": "Target profile uses whole positive days after a verified event; legal period is separately approved." } }, "required": [], "additionalProperties": false, "oneOf": [ { "required": [ "endAt" ], "not": { "required": [ "triggerEvent" ] } }, { "required": [ "triggerEvent", "durationAfterTrigger" ], "not": { "required": [ "endAt" ] } } ], "examples": [ { "endAt": "2036-10-15T00:00:00Z" } ] }, "Acknowledgement": { "type": "object", "properties": { "archiveId": { "type": "string" }, "jobId": { "type": "string" }, "policyId": { "type": "string" }, "policyVersion": { "type": "string" }, "receivedAt": { "type": "string", "format": "date-time" }, "state": { "const": "ACCEPTED" } }, "required": [ "archiveId", "jobId", "policyVersion", "receivedAt", "state" ], "additionalProperties": false, "examples": [ { "archiveId": "arc-test-001", "jobId": "job-test-001", "policyId": "policy-test-v1", "policyVersion": "1", "receivedAt": "2026-10-15T05:00:01Z", "state": "ACCEPTED" } ] }, "ArchiveObject": { "type": "object", "properties": { "archiveId": { "type": "string" }, "profileId": { "type": "string" }, "policyId": { "type": "string" }, "custody": { "type": "string" }, "mimeType": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "state": { "type": "string", "enum": [ "RECEIVED", "VALIDATING", "ACCEPTED", "EVIDENCE_PENDING", "EVIDENCE_READY", "REJECTED", "EVIDENCE_FAILED" ] }, "evidenceVersion": { "type": "integer", "minimum": 0 } }, "required": [ "archiveId", "state" ], "additionalProperties": false, "examples": [ { "archiveId": "arc-test-001", "profileId": "profile-test-01", "policyId": "policy-test-v1", "custody": "CUSTOMER_MANAGED", "mimeType": "text/plain", "metadata": { "title": "LTANS-SYN-001 / r1" }, "state": "EVIDENCE_READY", "evidenceVersion": 1 } ] }, "Job": { "type": "object", "properties": { "jobId": { "type": "string" }, "state": { "type": "string", "enum": [ "QUEUED", "RUNNING", "WAITING_EXTERNAL", "RETRY_PENDING", "SUCCEEDED", "FAILED", "CANCELLED" ] }, "resourceId": { "type": "string" }, "correlationId": { "type": "string" }, "pollAfterSeconds": { "type": "integer", "minimum": 1 }, "resultReference": { "type": "string", "description": "URI reference to the completed resource, for example /v1/verifications/ver-test-001. Resolve only against the configured API origin." }, "error": { "$ref": "#/components/schemas/Problem" } }, "required": [ "jobId", "state", "correlationId" ], "additionalProperties": false, "examples": [ { "jobId": "job-transfer-001", "state": "SUCCEEDED", "resourceId": "trf-test-001", "correlationId": "corr-test-001", "pollAfterSeconds": 2, "resultReference": "/v1/transfers/trf-test-001" } ] }, "EvidenceRecord": { "type": "object", "properties": { "archiveId": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "syntax": { "type": "string", "enum": [ "ASN1_ERS", "XMLERS" ] }, "mediaType": { "type": "string" }, "downloadReference": { "type": "string", "format": "uri-reference" }, "digest": { "$ref": "#/components/schemas/Digest" }, "policyHistory": { "type": "array", "items": { "type": "string" } } }, "required": [ "archiveId", "version", "syntax", "downloadReference" ], "additionalProperties": false, "examples": [ { "archiveId": "arc-test-001", "version": 1, "syntax": "ASN1_ERS", "mediaType": "application/octet-stream", "downloadReference": "/v1/downloads/evidence-test-001", "digest": { "algorithm": "SHA-256", "value": "0000000000000000000000000000000000000000000000000000000000000000" }, "policyHistory": [ "policy-test-v1" ] } ] }, "VerificationRequest": { "type": "object", "properties": { "evidenceVersion": { "type": "integer", "minimum": 1 }, "trustContextId": { "type": "string" }, "dataReference": { "type": "string", "format": "uri" } }, "required": [ "evidenceVersion", "trustContextId", "dataReference" ], "additionalProperties": false, "examples": [ { "evidenceVersion": 1, "trustContextId": "trust-test-001", "dataReference": "https://storage.example.invalid/test/object-001" } ] }, "VerificationReport": { "type": "object", "properties": { "verificationId": { "type": "string" }, "archiveId": { "type": "string" }, "outcome": { "type": "string", "enum": [ "VALID", "INVALID", "INDETERMINATE" ] }, "evaluatedAt": { "type": "string", "format": "date-time" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "check": { "type": "string" }, "outcome": { "type": "string", "enum": [ "VALID", "INVALID", "INDETERMINATE", "NOT_APPLICABLE" ] }, "detail": { "type": "string" }, "reasonCode": { "type": "string" } }, "required": [ "check", "outcome", "reasonCode" ], "additionalProperties": false }, "minItems": 1 }, "trustContextId": { "type": "string" }, "policyId": { "type": "string" }, "policyVersion": { "type": "string" }, "toolVersion": { "type": "string" }, "evidenceVersion": { "type": "integer", "minimum": 1 }, "reasonCodes": { "type": "array", "minItems": 1, "items": { "type": "string" } } }, "required": [ "verificationId", "archiveId", "outcome", "steps", "evaluatedAt", "trustContextId", "policyId", "policyVersion", "toolVersion", "evidenceVersion", "reasonCodes" ], "additionalProperties": false, "examples": [ { "verificationId": "ver-test-001", "archiveId": "arc-test-001", "outcome": "INDETERMINATE", "evaluatedAt": "2026-10-15T05:00:00Z", "trustContextId": "trust-test-001", "policyId": "policy-test-v1", "policyVersion": "1", "toolVersion": "target-validator-1", "evidenceVersion": 1, "reasonCodes": [ "TEST_TRUST_MATERIAL_NOT_SUPPLIED" ], "steps": [ { "check": "timestamp-path", "outcome": "INDETERMINATE", "reasonCode": "TEST_TRUST_MATERIAL_NOT_SUPPLIED", "detail": "Synthetic response: no trusted TSA token is bundled." } ] } ] }, "RenewalRequest": { "type": "object", "properties": { "archiveId": { "type": "string" }, "evidenceVersion": { "type": "integer", "minimum": 1 }, "mode": { "type": "string", "enum": [ "TIMESTAMP", "HASH_TREE" ] }, "dataReference": { "type": "string", "format": "uri" }, "approvalId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "archiveId", "evidenceVersion", "mode", "reason" ], "additionalProperties": false, "allOf": [ { "if": { "properties": { "mode": { "const": "HASH_TREE" } }, "required": [ "mode" ] }, "then": { "required": [ "dataReference", "approvalId" ] } } ], "examples": [ { "archiveId": "arc-test-001", "evidenceVersion": 1, "mode": "HASH_TREE", "dataReference": "https://storage.example.invalid/test/object-001", "approvalId": "approval-test-001", "reason": "Scheduled synthetic test" } ] }, "Renewal": { "type": "object", "properties": { "renewalId": { "type": "string" }, "archiveId": { "type": "string" }, "jobId": { "type": "string" }, "mode": { "type": "string" }, "state": { "type": "string", "enum": [ "DUE", "ASSESSED", "APPROVED", "RUNNING", "COMPLETED", "BLOCKED_DATA_ACCESS", "FAILED" ] } }, "required": [ "renewalId", "archiveId", "jobId", "state" ], "additionalProperties": false, "examples": [ { "renewalId": "ren-test-001", "archiveId": "arc-test-001", "jobId": "job-test-002", "mode": "HASH_TREE", "state": "APPROVED" } ] }, "ExportRequest": { "type": "object", "properties": { "evidenceVersion": { "type": "integer", "minimum": 1 }, "includePayload": { "type": "boolean" }, "recipientKeyId": { "type": "string" } }, "required": [ "evidenceVersion", "includePayload", "recipientKeyId" ], "additionalProperties": false, "examples": [ { "evidenceVersion": 1, "includePayload": true, "recipientKeyId": "recipient-test-001" } ] }, "TransferRequest": { "type": "object", "properties": { "exportId": { "type": "string" }, "destinationProfileId": { "type": "string" }, "approvalId": { "type": "string" } }, "required": [ "exportId", "destinationProfileId", "approvalId" ], "additionalProperties": false, "examples": [ { "exportId": "exp-test-001", "destinationProfileId": "destination-test-001", "approvalId": "approval-test-002" } ] }, "Profile": { "type": "object", "properties": { "profileId": { "type": "string" }, "policyId": { "type": "string" }, "version": { "type": "string" }, "syntax": { "type": "string", "enum": [ "XMLERS", "ASN1_ERS" ] }, "tsaProfileId": { "type": "string" }, "status": { "type": "string", "enum": [ "DRAFT", "REVIEW", "APPROVED", "EFFECTIVE", "SUPERSEDED" ] } }, "required": [ "profileId", "policyId", "version", "status" ], "additionalProperties": false, "examples": [ { "profileId": "profile-test-01", "policyId": "policy-test-v1", "version": "1", "syntax": "ASN1_ERS", "tsaProfileId": "tsa-test-001", "status": "EFFECTIVE" } ] }, "Policy": { "type": "object", "properties": { "policyId": { "type": "string" }, "version": { "type": "string" }, "retentionRule": { "type": "string" }, "renewalRule": { "type": "string" }, "dispositionRule": { "type": "string" }, "releaseId": { "type": "string" }, "status": { "type": "string", "enum": [ "DRAFT", "REVIEW", "APPROVED", "EFFECTIVE", "SUPERSEDED" ] } }, "required": [ "policyId", "version", "status" ], "additionalProperties": false, "examples": [ { "policyId": "policy-test-v1", "version": "1", "retentionRule": "Synthetic 10-year test rule, not a legal requirement", "renewalRule": "Scheduled risk review", "dispositionRule": "Approval and no active hold", "releaseId": "synthetic-release-001", "status": "EFFECTIVE" } ] }, "HoldRequest": { "type": "object", "properties": { "caseId": { "type": "string" }, "reason": { "type": "string" }, "approvalId": { "type": "string" } }, "required": [ "caseId", "reason", "approvalId" ], "additionalProperties": false, "examples": [ { "caseId": "case-test-001", "reason": "Synthetic hold test", "approvalId": "approval-test-003" } ] }, "DispositionRequest": { "type": "object", "properties": { "scope": { "type": "string", "enum": [ "PAYLOAD", "EVIDENCE", "BOTH" ] }, "approvalId": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "scope", "approvalId", "reason" ], "additionalProperties": false, "examples": [ { "scope": "PAYLOAD", "approvalId": "approval-test-004", "reason": "Synthetic expiry test" } ] }, "Webhook": { "type": "object", "properties": { "webhookId": { "type": "string" }, "endpoint": { "type": "string", "format": "uri", "pattern": "^https://" }, "events": { "type": "array", "items": { "type": "string", "enum": [ "ArchiveRequested", "ArchiveAccepted", "ArchiveRejected", "EvidenceGenerationRequested", "EvidenceGenerated", "EvidenceGenerationFailed", "VerificationRequested", "VerificationCompleted", "RenewalDue", "RenewalStarted", "RenewalCompleted", "RenewalFailed", "ExportRequested", "ExportCompleted", "TransferStarted", "TransferCompleted", "DispositionRequested", "DispositionApproved", "DispositionCompleted" ] }, "minItems": 1, "uniqueItems": true }, "signingKeyId": { "type": "string" }, "state": { "type": "string", "enum": [ "PENDING_VERIFICATION", "ACTIVE", "SUSPENDED" ] } }, "required": [ "endpoint", "events", "signingKeyId" ], "additionalProperties": false, "examples": [ { "webhookId": "wh-test-001", "endpoint": "https://receiver.example.invalid/events", "events": [ "EvidenceGenerated" ], "signingKeyId": "key-test-001", "state": "PENDING_VERIFICATION" } ] }, "ResourceResult": { "type": "object", "properties": { "resourceId": { "type": "string" }, "state": { "type": "string" }, "jobId": { "type": "string" }, "manifestReference": { "type": "string" }, "acknowledgementId": { "type": "string" } }, "required": [ "resourceId", "state" ], "additionalProperties": false, "examples": [ { "resourceId": "exp-test-001", "state": "PACKAGING", "jobId": "job-test-003" } ], "description": "Legacy generic draft result retained for historical client examples only. Export/transfer/hold/audit/usage operations use dedicated schemas in draft 3." }, "Problem": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "code": { "type": "string" }, "detail": { "type": "string" }, "correlationId": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "service": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "errors": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "field", "reason" ], "additionalProperties": false } }, "status": { "type": "integer", "minimum": 400, "maximum": 599 }, "instance": { "type": "string", "format": "uri-reference" } }, "required": [ "type", "title", "status", "code", "detail", "correlationId", "requestId", "retryable", "service", "timestamp", "errors" ], "additionalProperties": false, "examples": [ { "type": "https://example.invalid/problems/profile-inactive", "title": "Inactive profile", "code": "PROFILE_INACTIVE", "detail": "Select an effective permitted profile.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Policy Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } ] }, "ArchiveList": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ArchiveObject" } }, "nextCursor": { "type": "string" } }, "required": [ "items" ], "additionalProperties": false, "examples": [ { "items": [ { "archiveId": "arc-test-001", "profileId": "profile-test-01", "policyId": "policy-test-v1", "custody": "CUSTOMER_MANAGED", "mimeType": "text/plain", "metadata": { "title": "LTANS-SYN-001 / r1" }, "state": "EVIDENCE_READY", "evidenceVersion": 1 } ] } ] }, "ProfileList": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Profile" } }, "nextCursor": { "type": "string" } }, "required": [ "items" ], "additionalProperties": false, "examples": [ { "items": [ { "profileId": "profile-test-01", "policyId": "policy-test-v1", "version": "1", "syntax": "ASN1_ERS", "tsaProfileId": "tsa-test-001", "status": "EFFECTIVE" } ] } ] }, "AuditList": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AuditRecord" } } }, "required": [ "items" ], "additionalProperties": false, "examples": [ { "items": [ { "auditRecordId": "aud-test-001", "resourceType": "Transfer", "resourceId": "trf-test-001", "action": "TRANSFER_ACKNOWLEDGED", "actorId": "recipient-test-001", "occurredAt": "2026-10-15T09:00:00Z", "correlationId": "corr-test-001" } ] } ] }, "UsageList": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/UsageRecord" } } }, "required": [ "items" ], "additionalProperties": false, "examples": [ { "items": [ { "usageRecordId": "usage-test-001", "periodStart": "2026-10-01T00:00:00Z", "periodEnd": "2026-11-01T00:00:00Z", "metric": "acceptedObjects", "quantity": 1, "unit": "object", "sourceReference": "/v1/archives/arc-test-001" } ] } ] }, "ExportResult": { "type": "object", "properties": { "exportId": { "type": "string", "pattern": "^exp-" }, "archiveId": { "type": "string", "pattern": "^arc-" }, "state": { "type": "string", "enum": [ "QUEUED", "PACKAGING", "EXPORTED", "FAILED" ] }, "jobId": { "type": "string" }, "manifestReference": { "type": "string", "format": "uri-reference" }, "packageDigest": { "$ref": "#/components/schemas/Digest" } }, "required": [ "exportId", "archiveId", "state", "jobId" ], "additionalProperties": false, "examples": [ { "exportId": "exp-test-001", "archiveId": "arc-test-001", "state": "EXPORTED", "jobId": "job-export-001", "manifestReference": "/assigned-channel/exp-test-001/manifest.json", "packageDigest": { "algorithm": "SHA-256", "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1" } } ] }, "TransferResult": { "type": "object", "properties": { "transferId": { "type": "string", "pattern": "^trf-" }, "archiveId": { "type": "string", "pattern": "^arc-" }, "exportId": { "type": "string", "pattern": "^exp-" }, "recipientId": { "type": "string" }, "scope": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "QUEUED", "TRANSFERRING", "AWAITING_ACKNOWLEDGEMENT", "ACKNOWLEDGED", "REJECTED", "FAILED" ] }, "jobId": { "type": "string" }, "packageDigest": { "$ref": "#/components/schemas/Digest" }, "acknowledgementId": { "type": "string" }, "acceptedAt": { "type": "string", "format": "date-time" } }, "required": [ "transferId", "archiveId", "exportId", "recipientId", "scope", "state", "jobId", "packageDigest" ], "additionalProperties": false, "examples": [ { "transferId": "trf-test-001", "archiveId": "arc-test-001", "exportId": "exp-test-001", "recipientId": "recipient-test-001", "state": "AWAITING_ACKNOWLEDGEMENT", "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example", "jobId": "job-transfer-001", "packageDigest": { "algorithm": "SHA-256", "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1" } } ], "allOf": [ { "if": { "properties": { "state": { "const": "ACKNOWLEDGED" } }, "required": [ "state" ] }, "then": { "required": [ "acknowledgementId", "acceptedAt" ] } } ] }, "TransferAcknowledgement": { "type": "object", "properties": { "transferId": { "type": "string", "pattern": "^trf-" }, "exportId": { "type": "string", "pattern": "^exp-" }, "recipientId": { "type": "string" }, "packageDigest": { "$ref": "#/components/schemas/Digest" }, "verificationReportReference": { "type": "string", "format": "uri-reference" }, "scope": { "type": "string", "minLength": 1 }, "acceptedAt": { "type": "string", "format": "date-time" } }, "required": [ "transferId", "exportId", "recipientId", "packageDigest", "verificationReportReference", "scope", "acceptedAt" ], "additionalProperties": false, "examples": [ { "transferId": "trf-test-001", "exportId": "exp-test-001", "recipientId": "recipient-test-001", "packageDigest": { "algorithm": "SHA-256", "value": "5c34a84b064c4aa79bbc8f49cadeea9c55cfc9df10d655e9bc6f7a6af248e1c1" }, "verificationReportReference": "urn:ltans:synthetic:recipient-report-001", "scope": "Complete manifest inventory for exp-test-001; cryptographic verification outside this synthetic example", "acceptedAt": "2026-10-15T09:00:00Z" } ], "description": "Recipient statement for the exact transfer/package/scope. Server must bind authenticated recipient and path transferId, compare exportId and packageDigest, authorize scope, and preserve the statement. Digest alone is not an acknowledgement or proof of cryptographic verification." }, "HoldResult": { "type": "object", "properties": { "holdId": { "type": "string", "pattern": "^hold-" }, "archiveId": { "type": "string", "pattern": "^arc-" }, "state": { "type": "string", "enum": [ "ACTIVE", "RELEASED" ] }, "caseId": { "type": "string" } }, "required": [ "holdId", "archiveId", "state", "caseId" ], "additionalProperties": false, "examples": [ { "holdId": "hold-test-001", "archiveId": "arc-test-001", "state": "ACTIVE", "caseId": "case-test-001" } ] }, "AuditRecord": { "type": "object", "properties": { "auditRecordId": { "type": "string" }, "resourceType": { "type": "string" }, "resourceId": { "type": "string" }, "action": { "type": "string" }, "actorId": { "type": "string" }, "occurredAt": { "type": "string", "format": "date-time" }, "correlationId": { "type": "string" } }, "required": [ "auditRecordId", "resourceType", "resourceId", "action", "actorId", "occurredAt", "correlationId" ], "additionalProperties": false, "examples": [ { "auditRecordId": "aud-test-001", "resourceType": "Transfer", "resourceId": "trf-test-001", "action": "TRANSFER_ACKNOWLEDGED", "actorId": "recipient-test-001", "occurredAt": "2026-10-15T09:00:00Z", "correlationId": "corr-test-001" } ] }, "UsageRecord": { "type": "object", "properties": { "usageRecordId": { "type": "string" }, "periodStart": { "type": "string", "format": "date-time" }, "periodEnd": { "type": "string", "format": "date-time" }, "metric": { "type": "string" }, "quantity": { "type": "integer", "minimum": 0 }, "unit": { "type": "string" }, "sourceReference": { "type": "string" } }, "required": [ "usageRecordId", "periodStart", "periodEnd", "metric", "quantity", "unit", "sourceReference" ], "additionalProperties": false, "examples": [ { "usageRecordId": "usage-test-001", "periodStart": "2026-10-01T00:00:00Z", "periodEnd": "2026-11-01T00:00:00Z", "metric": "acceptedObjects", "quantity": 1, "unit": "object", "sourceReference": "/v1/archives/arc-test-001" } ] }, "ArchiveRequested": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "ArchiveRequested" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "REQUESTED" }, "resourceType": { "const": "ArchiveObject" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-archiverequested-001", "eventName": "ArchiveRequested", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 1, "correlationId": "corr-test-001", "idempotencyKey": "event-archiverequested-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "REQUESTED", "resourceType": "ArchiveObject", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001" } ] }, "ArchiveAccepted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "ArchiveAccepted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "ACCEPTED" }, "resourceType": { "const": "ArchiveObject" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-archiveaccepted-001", "eventName": "ArchiveAccepted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 2, "correlationId": "corr-test-001", "idempotencyKey": "event-archiveaccepted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "ACCEPTED", "resourceType": "ArchiveObject", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001" } ] }, "ArchiveRejected": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "ArchiveRejected" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "REJECTED" }, "resourceType": { "const": "ArchiveObject" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-archiverejected-001", "eventName": "ArchiveRejected", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 3, "correlationId": "corr-test-001", "idempotencyKey": "event-archiverejected-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "REJECTED", "resourceType": "ArchiveObject", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001" } ] }, "EvidenceGenerationRequested": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "EvidenceGenerationRequested" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "REQUESTED" }, "resourceType": { "const": "EvidenceRecord" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/arc-test-001/evidence/" }, "evidenceVersion": { "type": "integer", "minimum": 1 } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference", "evidenceVersion" ], "additionalProperties": false, "examples": [ { "eventId": "evt-evidencegenerationrequested-001", "eventName": "EvidenceGenerationRequested", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 4, "correlationId": "corr-test-001", "idempotencyKey": "event-evidencegenerationrequested-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "REQUESTED", "resourceType": "EvidenceRecord", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001/evidence/1", "evidenceVersion": 1 } ] }, "EvidenceGenerated": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "EvidenceGenerated" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "PUBLISHED" }, "resourceType": { "const": "EvidenceRecord" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/arc-test-001/evidence/" }, "evidenceVersion": { "type": "integer", "minimum": 1 } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference", "evidenceVersion" ], "additionalProperties": false, "examples": [ { "eventId": "evt-evidencegenerated-001", "eventName": "EvidenceGenerated", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 5, "correlationId": "corr-test-001", "idempotencyKey": "event-evidencegenerated-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "PUBLISHED", "resourceType": "EvidenceRecord", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001/evidence/1", "evidenceVersion": 1 } ] }, "EvidenceGenerationFailed": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "EvidenceGenerationFailed" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "FAILED" }, "resourceType": { "const": "Job" }, "resourceId": { "type": "string", "pattern": "^job-" }, "reference": { "type": "string", "pattern": "^/v1/jobs/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-evidencegenerationfailed-001", "eventName": "EvidenceGenerationFailed", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 6, "correlationId": "corr-test-001", "idempotencyKey": "event-evidencegenerationfailed-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "FAILED", "resourceType": "Job", "resourceId": "job-evidence-001", "reference": "/v1/jobs/job-evidence-001" } ] }, "VerificationRequested": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "VerificationRequested" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "REQUESTED" }, "resourceType": { "const": "VerificationReport" }, "resourceId": { "type": "string", "pattern": "^ver-" }, "reference": { "type": "string", "pattern": "^/v1/verifications/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-verificationrequested-001", "eventName": "VerificationRequested", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 7, "correlationId": "corr-test-001", "idempotencyKey": "event-verificationrequested-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "REQUESTED", "resourceType": "VerificationReport", "resourceId": "ver-test-001", "reference": "/v1/verifications/ver-test-001" } ] }, "VerificationCompleted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "VerificationCompleted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "COMPLETED" }, "resourceType": { "const": "VerificationReport" }, "resourceId": { "type": "string", "pattern": "^ver-" }, "reference": { "type": "string", "pattern": "^/v1/verifications/" }, "outcome": { "type": "string", "enum": [ "VALID", "INVALID", "INDETERMINATE" ] } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference", "outcome" ], "additionalProperties": false, "examples": [ { "eventId": "evt-verificationcompleted-001", "eventName": "VerificationCompleted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 8, "correlationId": "corr-test-001", "idempotencyKey": "event-verificationcompleted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "COMPLETED", "resourceType": "VerificationReport", "resourceId": "ver-test-001", "reference": "/v1/verifications/ver-test-001", "outcome": "INDETERMINATE" } ] }, "RenewalDue": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "RenewalDue" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "DUE" }, "resourceType": { "const": "ArchiveObject" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-renewaldue-001", "eventName": "RenewalDue", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 9, "correlationId": "corr-test-001", "idempotencyKey": "event-renewaldue-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "DUE", "resourceType": "ArchiveObject", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001" } ] }, "RenewalStarted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "RenewalStarted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "RUNNING" }, "resourceType": { "const": "Renewal" }, "resourceId": { "type": "string", "pattern": "^ren-" }, "reference": { "type": "string", "pattern": "^/v1/renewals/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-renewalstarted-001", "eventName": "RenewalStarted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 10, "correlationId": "corr-test-001", "idempotencyKey": "event-renewalstarted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "RUNNING", "resourceType": "Renewal", "resourceId": "ren-test-001", "reference": "/v1/renewals/ren-test-001" } ] }, "RenewalCompleted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "RenewalCompleted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "COMPLETED" }, "resourceType": { "const": "Renewal" }, "resourceId": { "type": "string", "pattern": "^ren-" }, "reference": { "type": "string", "pattern": "^/v1/renewals/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-renewalcompleted-001", "eventName": "RenewalCompleted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 11, "correlationId": "corr-test-001", "idempotencyKey": "event-renewalcompleted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "COMPLETED", "resourceType": "Renewal", "resourceId": "ren-test-001", "reference": "/v1/renewals/ren-test-001" } ] }, "RenewalFailed": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "RenewalFailed" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "FAILED" }, "resourceType": { "const": "Renewal" }, "resourceId": { "type": "string", "pattern": "^ren-" }, "reference": { "type": "string", "pattern": "^/v1/renewals/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-renewalfailed-001", "eventName": "RenewalFailed", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 12, "correlationId": "corr-test-001", "idempotencyKey": "event-renewalfailed-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "FAILED", "resourceType": "Renewal", "resourceId": "ren-test-001", "reference": "/v1/renewals/ren-test-001" } ] }, "ExportRequested": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "ExportRequested" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "QUEUED" }, "resourceType": { "const": "ExportResult" }, "resourceId": { "type": "string", "pattern": "^exp-" }, "reference": { "type": "string", "pattern": "^/v1/exports/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-exportrequested-001", "eventName": "ExportRequested", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 13, "correlationId": "corr-test-001", "idempotencyKey": "event-exportrequested-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "QUEUED", "resourceType": "ExportResult", "resourceId": "exp-test-001", "reference": "/v1/exports/exp-test-001" } ] }, "ExportCompleted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "ExportCompleted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "EXPORTED" }, "resourceType": { "const": "ExportResult" }, "resourceId": { "type": "string", "pattern": "^exp-" }, "reference": { "type": "string", "pattern": "^/v1/exports/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-exportcompleted-001", "eventName": "ExportCompleted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 14, "correlationId": "corr-test-001", "idempotencyKey": "event-exportcompleted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "EXPORTED", "resourceType": "ExportResult", "resourceId": "exp-test-001", "reference": "/v1/exports/exp-test-001" } ] }, "TransferStarted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "TransferStarted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "TRANSFERRING" }, "resourceType": { "const": "TransferResult" }, "resourceId": { "type": "string", "pattern": "^trf-" }, "reference": { "type": "string", "pattern": "^/v1/transfers/" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference" ], "additionalProperties": false, "examples": [ { "eventId": "evt-transferstarted-001", "eventName": "TransferStarted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 15, "correlationId": "corr-test-001", "idempotencyKey": "event-transferstarted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "TRANSFERRING", "resourceType": "TransferResult", "resourceId": "trf-test-001", "reference": "/v1/transfers/trf-test-001" } ] }, "TransferCompleted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "TransferCompleted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "ACKNOWLEDGED" }, "resourceType": { "const": "TransferResult" }, "resourceId": { "type": "string", "pattern": "^trf-" }, "reference": { "type": "string", "pattern": "^/v1/transfers/" }, "exportId": { "type": "string", "minLength": 1 }, "recipientId": { "type": "string", "minLength": 1 }, "acknowledgementId": { "type": "string", "minLength": 1 } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference", "exportId", "recipientId", "acknowledgementId" ], "additionalProperties": false, "examples": [ { "eventId": "evt-transfercompleted-001", "eventName": "TransferCompleted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 16, "correlationId": "corr-test-001", "idempotencyKey": "event-transfercompleted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "ACKNOWLEDGED", "resourceType": "TransferResult", "resourceId": "trf-test-001", "reference": "/v1/transfers/trf-test-001", "exportId": "exp-test-001", "recipientId": "recipient-test-001", "acknowledgementId": "ack-test-001" } ] }, "DispositionRequested": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "DispositionRequested" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "REQUESTED" }, "resourceType": { "const": "ArchiveObject" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/" }, "decisionId": { "type": "string", "pattern": "^disp-" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference", "decisionId" ], "additionalProperties": false, "examples": [ { "eventId": "evt-dispositionrequested-001", "eventName": "DispositionRequested", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 17, "correlationId": "corr-test-001", "idempotencyKey": "event-dispositionrequested-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "REQUESTED", "resourceType": "ArchiveObject", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001", "decisionId": "disp-test-001" } ] }, "DispositionApproved": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "DispositionApproved" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "APPROVED" }, "resourceType": { "const": "ArchiveObject" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/" }, "decisionId": { "type": "string", "pattern": "^disp-" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference", "decisionId" ], "additionalProperties": false, "examples": [ { "eventId": "evt-dispositionapproved-001", "eventName": "DispositionApproved", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 18, "correlationId": "corr-test-001", "idempotencyKey": "event-dispositionapproved-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "APPROVED", "resourceType": "ArchiveObject", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001", "decisionId": "disp-test-001" } ] }, "DispositionCompleted": { "type": "object", "properties": { "eventId": { "type": "string", "minLength": 1 }, "eventName": { "const": "DispositionCompleted" }, "version": { "const": "2.0" }, "aggregateType": { "const": "ArchiveObject" }, "aggregateId": { "type": "string", "pattern": "^arc-" }, "aggregateRevision": { "type": "integer", "minimum": 1 }, "correlationId": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 1 }, "occurredAt": { "type": "string", "format": "date-time" }, "state": { "const": "COMPLETED" }, "resourceType": { "const": "ArchiveObject" }, "resourceId": { "type": "string", "pattern": "^arc-" }, "reference": { "type": "string", "pattern": "^/v1/archives/" }, "decisionId": { "type": "string", "pattern": "^disp-" } }, "required": [ "eventId", "eventName", "version", "aggregateType", "aggregateId", "aggregateRevision", "correlationId", "idempotencyKey", "occurredAt", "state", "resourceType", "resourceId", "reference", "decisionId" ], "additionalProperties": false, "examples": [ { "eventId": "evt-dispositioncompleted-001", "eventName": "DispositionCompleted", "version": "2.0", "aggregateType": "ArchiveObject", "aggregateId": "arc-test-001", "aggregateRevision": 19, "correlationId": "corr-test-001", "idempotencyKey": "event-dispositioncompleted-001", "occurredAt": "2026-10-15T08:00:00Z", "state": "COMPLETED", "resourceType": "ArchiveObject", "resourceId": "arc-test-001", "reference": "/v1/archives/arc-test-001", "decisionId": "disp-test-001" } ] } }, "parameters": { "CorrelationId": { "name": "X-Correlation-ID", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 128 } }, "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": true, "description": "Bind to tenant, method, resource and canonical body digest; changed body with same key returns 409. Replay window must be agreed before production.", "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }, "Cursor": { "name": "cursor", "in": "query", "schema": { "type": "string" } }, "Limit": { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } } }, "securitySchemes": { "OAuth2": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://identity.example.invalid/oauth/token", "scopes": { "archives:write": "archives access", "archives:read": "archives access", "evidence:read": "evidence access", "verification:write": "verification access", "verification:read": "verification access", "renewals:write": "renewals access", "renewals:read": "renewals access", "policies:read": "policies access", "exports:write": "exports access", "exports:read": "exports access", "transfers:write": "transfers access", "transfers:read": "transfers access", "transfers:acknowledge": "transfers access", "jobs:read": "jobs access", "webhooks:write": "webhooks access", "webhooks:read": "webhooks access", "holds:write": "holds access", "disposition:write": "disposition access", "audit:read": "audit access", "billing:read": "billing access" } } } }, "MutualTLS": { "type": "mutualTLS" } }, "responses": { "Problem": { "description": "Canonical error; inspect retryable and correlationId.", "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 }, "description": "For retryable throttling or temporary unavailability." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://example.invalid/problems/profile-inactive", "title": "Inactive profile", "code": "PROFILE_INACTIVE", "detail": "Select an effective permitted profile.", "correlationId": "corr-test-001", "requestId": "req-test-001", "retryable": false, "service": "Policy Service", "timestamp": "2026-10-15T05:00:01Z", "errors": [], "status": 422, "instance": "urn:ltans:request:req-test-001" } } } } } } }