{"openapi":"3.1.0","info":{"title":"VeriSigil AI — Constitutional Execution Substrate","description":"Consequence-boundary verification for AI-governed actions. Evidence-first engineering. Proof scope: see /health and endpoint_proof_matrix for current evidence status.","version":"1.0.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/health/detailed":{"get":{"tags":["System"],"summary":"Health Detailed","description":"Detailed health with metrics. Canonical = GET /health (liveness). This adds runtime metrics.","operationId":"health_detailed_health_detailed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/status":{"get":{"tags":["System"],"summary":"Status","operationId":"status_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/admin/system":{"get":{"tags":["Admin"],"summary":"Admin System","operationId":"admin_system_admin_system_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/progression/evaluate":{"post":{"tags":["Progression Admissibility"],"summary":"Evaluate Progression Endpoint","description":"PROGRESSION ADMISSIBILITY ENGINE\n\nThe next layer beyond identity + action enforcement.\nEvaluates whether a specific workflow state transition\nshould be permitted given:\n- Trajectory coherence (does this make sense given prior steps?)\n- Authority sufficiency (does agent have authority for this consequence?)\n- Evidence sufficiency (is the proof complete for this action?)\n- Consequence level (LOW / MEDIUM / HIGH / CRITICAL)\n\nReturns one of:\n- PROGRESSION_ALLOWED\n- PROGRESSION_BLOCKED\n- PROGRESSION_REQUIRES_EVIDENCE\n- PROGRESSION_REQUIRES_AUTHORITY\n- PROGRESSION_REQUIRES_HUMAN_REVIEW\n- PROGRESSION_TRAJECTORY_ANOMALY\n\nEvery decision chained to immutable Merkle audit trail.","operationId":"evaluate_progression_endpoint_v1_progression_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/progression/simulate":{"post":{"tags":["Progression Admissibility"],"summary":"Simulate Progression","description":"Simulate a progression decision without logging to audit trail.\nUse this to test your workflow configuration before going live.","operationId":"simulate_progression_v1_progression_simulate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/provenance/start":{"post":{"tags":["Runtime Governance"],"summary":"Start Chain","description":"Start a new agent chain — call when first agent initiates a workflow.","operationId":"start_chain_v1_chain_provenance_start_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"workflow_id","in":"query","required":true,"schema":{"type":"string","title":"Workflow Id"}},{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/provenance/record":{"post":{"tags":["Runtime Governance"],"summary":"Record Chain Call","description":"Record one agent calling another within a chain.","operationId":"record_chain_call_v1_chain_provenance_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainCallRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/provenance/{chain_id}":{"get":{"tags":["Runtime Governance"],"summary":"Get Provenance","description":"Get full provenance for an agent chain — who called who with what authority.","operationId":"get_provenance_v1_chain_provenance__chain_id__get","parameters":[{"name":"chain_id","in":"path","required":true,"schema":{"type":"string","title":"Chain Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/provenance":{"get":{"tags":["Runtime Governance"],"summary":"List Chains","description":"List all active agent chains.","operationId":"list_chains_v1_chain_provenance_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuous/start":{"post":{"tags":["Runtime Governance"],"summary":"Start Monitor","description":"Start continuous admissibility monitoring for a long-running agent.","operationId":"start_monitor_v1_continuous_start_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"workflow_id","in":"query","required":true,"schema":{"type":"string","title":"Workflow Id"}},{"name":"interval_sec","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Interval Sec"}},{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuous/check":{"post":{"tags":["Runtime Governance"],"summary":"Check Continuous","description":"Run one continuous admissibility check.\nAgent calls this periodically to confirm it can continue executing.\nReturns ADMISSIBLE, PAUSE_REQUIRED, or HALT_REQUIRED.","operationId":"check_continuous_v1_continuous_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContinuousCheckRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuous/{monitor_id}":{"get":{"tags":["Runtime Governance"],"summary":"Get Monitor","description":"Get current status of a continuous monitor.","operationId":"get_monitor_v1_continuous__monitor_id__get","parameters":[{"name":"monitor_id","in":"path","required":true,"schema":{"type":"string","title":"Monitor Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/revalidate":{"post":{"tags":["Runtime Governance"],"summary":"Revalidate","description":"Revalidate a previously approved execution at a new workflow step.\nChecks if the original decision still holds given current context.\nReturns still_valid: true/false and new decision if changed.","operationId":"revalidate_v1_revalidate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/revalidate/{execution_id}":{"get":{"tags":["Runtime Governance"],"summary":"Get Revalidations","description":"Get all revalidation records for an execution.","operationId":"get_revalidations_v1_revalidate__execution_id__get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/transitions/map":{"post":{"tags":["Operational State Governance"],"summary":"Map Transitions","description":"PERMISSIBLE TRANSITION SPACE MAPPING\n\nGiven current operational state and conditions —\nmap the full space of transitions that remain permissible.\n\nReturns:\n- permissible: transitions agent can take autonomously\n- requires_approval: transitions needing human gate\n- restricted: transitions blocked under current conditions\n- consequence_binding: irreversible transitions with binding points\n- recommendation: what the agent should do next\n\nThis answers: 'What state transitions remain permissible\nunder current conditions before consequence binds?'","operationId":"map_transitions_v1_transitions_map_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"workflow_id","in":"query","required":true,"schema":{"type":"string","title":"Workflow Id"}},{"name":"current_step","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Current Step"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/transitions/binding-point":{"post":{"tags":["Operational State Governance"],"summary":"Detect Binding","description":"CONSEQUENCE BINDING POINT DETECTION\n\nIdentify the exact moment in a workflow where a decision\nbecomes irreversible — where consequence binds.\n\nBefore binding point: governance can intervene.\nAfter binding point: consequence has propagated.\n\nReturns:\n- binding_point: the exact event that binds consequence\n- intervention_window_open: whether governance can still act\n- propagation_risk: CATASTROPHIC / HIGH / MEDIUM / LOW\n- last_intervention_step: last opportunity to prevent binding\n- governance_recommendation: what to do right now","operationId":"detect_binding_v1_transitions_binding_point_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/conditions/update":{"post":{"tags":["Operational State Governance"],"summary":"Update Conditions","description":"OPERATIONAL CONDITION MONITOR\n\nWhen operational conditions change — automatically\nre-evaluate all active permissions.\n\nConditions change → permissions automatically re-evaluated.\nRevoked permissions logged to immutable chain.\nNo manual intervention required.\n\nTriggers on:\n- Trust score degradation\n- New active alerts\n- Regulatory changes\n- Environment changes\n\nReturns:\n- revoked: permissions automatically revoked\n- restricted: permissions suspended until conditions resolve\n- maintained: permissions still valid\n- auto_revoked: true if any permissions were revoked","operationId":"update_conditions_v1_conditions_update_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/conditions/{agent_id}/{workflow_id}":{"get":{"tags":["Operational State Governance"],"summary":"Get Conditions","description":"Get current operational conditions for an agent/workflow.","operationId":"get_conditions_v1_conditions__agent_id___workflow_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/transitions/taxonomy":{"get":{"tags":["Operational State Governance"],"summary":"Get Taxonomy","description":"Get the full transition consequence taxonomy.\nShows binding risk, reversibility, and consequence level\nfor every supported action type.","operationId":"get_taxonomy_v1_transitions_taxonomy_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/evaluate":{"post":{"tags":["Cognitive Governance"],"summary":"Cognitive Evaluate","description":"COGNITIVE GOVERNANCE INTERFACE LAYER\n\nEvaluates the quality of a governance decision before\npresenting it to a human approver.\n\n7 dimensions:\n1. Confidence Integrity Scoring — how reliable is the confidence?\n2. Uncertainty Exposure Enforcement — how uncertain should this feel?\n3. Ambiguity Disclosure Requirements — what must be disclosed?\n4. Evidence Completeness Indicators — what evidence exists vs missing?\n5. Adversarial Explanation Detection — is the explanation misleading?\n6. Human Comprehension Verification — can a human genuinely decide?\n7. Decision Friction Controls — how much friction should the interface apply?\n\nReturns complete interface guidance for the approval console.\nGovernance is not just the decision — it is how that decision\nis presented to the human who must own it.","operationId":"cognitive_evaluate_v1_cognitive_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CognitiveGovernanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/friction":{"post":{"tags":["Cognitive Governance"],"summary":"Get Friction Controls","description":"Get decision friction controls for a given governance scenario.\nReturns exact friction level, delay, and acknowledgment requirements.","operationId":"get_friction_controls_v1_cognitive_friction_post","parameters":[{"name":"consequence","in":"query","required":false,"schema":{"type":"string","default":"HIGH","title":"Consequence"}},{"name":"confidence","in":"query","required":false,"schema":{"type":"number","default":0.75,"title":"Confidence"}},{"name":"integrity_score","in":"query","required":false,"schema":{"type":"number","default":0.8,"title":"Integrity Score"}},{"name":"completeness_score","in":"query","required":false,"schema":{"type":"number","default":0.8,"title":"Completeness Score"}},{"name":"adversarial_risk","in":"query","required":false,"schema":{"type":"number","default":0.1,"title":"Adversarial Risk"}},{"name":"comprehension_ready","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Comprehension Ready"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/snapshot":{"post":{"tags":["Document Integrity"],"summary":"Document Snapshot","description":"CREATE DOCUMENT INTEGRITY SNAPSHOT\n\nCryptographic baseline before any agent interaction.\nSHA-256 hash of full content + individual field hashes.\n\nCall this BEFORE any agent touches the document.\nAll future verifications compare against this baseline.\n\nBased on Microsoft Research:\n'LLMs Corrupt Your Documents When You Delegate'\nGPT-5: 91.5% integrity at 2 interactions → 48.3% at 20 interactions.","operationId":"document_snapshot_v1_document_snapshot_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentSnapshotRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/verify-legacy":{"post":{"tags":["Document Integrity"],"summary":"Document Verify","description":"VERIFY DOCUMENT INTEGRITY\n\nCompare current document state against original snapshot.\nDetects corruption even when the document looks finished.\n\nReturns:\n- integrity_score: 0.0 (corrupted) → 1.0 (intact)\n- corruption_risk: LOW / MEDIUM / HIGH / CRITICAL\n- field_violations: which specific fields were mutated\n- msresearch_note: comparison vs Microsoft Research baseline\n- corruption_invisible: true if document looks OK but is corrupted\n- recommendation: PROCEED / REVIEW / HALT / REJECT\n\nCall after EVERY agent interaction on regulated documents.","operationId":"document_verify_v1_document_verify_legacy_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/{document_id}/report":{"get":{"tags":["Document Integrity"],"summary":"Document Report","description":"DOCUMENT INTEGRITY REPORT\n\nFull integrity history for a document across all interactions.\nShows the degradation curve — how integrity changed over time.\nIncludes Microsoft Research comparison baseline.","operationId":"document_report_v1_document__document_id__report_get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/{document_id}/status":{"get":{"tags":["Document Integrity"],"summary":"Document Status","description":"Quick document integrity status check.","operationId":"document_status_v1_document__document_id__status_get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/documents":{"get":{"tags":["Document Integrity"],"summary":"List Documents","description":"List all tracked documents and their integrity status.","operationId":"list_documents_v1_documents_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/full-verify":{"post":{"tags":["Document Integrity"],"summary":"Full Document Verify","description":"FULL DOCUMENT INTEGRITY VERIFICATION\nCombines structural + semantic verification in one call.\nReturns:\n- Structural integrity (hash-based)\n- Semantic integrity (meaning-based)\n- Combined integrity score\n- Unified recommendation\n- All violations from both layers","operationId":"full_document_verify_v1_document_full_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FullVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/invariants":{"get":{"tags":["Formal Governance"],"summary":"List Invariants","description":"VGS-001: List all 40 governance invariants.\nMachine-enforceable governance law.\nViolations halt execution immediately — no exceptions.","operationId":"list_invariants_v1_invariants_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/invariants/check":{"post":{"tags":["Formal Governance"],"summary":"Check Governance Invariants","description":"VGS-001: Check all applicable invariants for an action.\nHard stop on any violation. Returns full invariant report.","operationId":"check_governance_invariants_v1_invariants_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvariantCheckRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/receipt":{"post":{"tags":["Formal Governance"],"summary":"Create Governance Receipt","description":"VGS-004: Generate cryptographic governance receipt.\nForensic evidence artifact. Cross-jurisdiction verifiable.\nEvery governance decision deserves a signed receipt.","operationId":"create_governance_receipt_v1_governance_receipt_post","parameters":[{"name":"decision_id","in":"query","required":true,"schema":{"type":"string","title":"Decision Id"}},{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"action_type","in":"query","required":true,"schema":{"type":"string","title":"Action Type"}},{"name":"decision","in":"query","required":true,"schema":{"type":"string","title":"Decision"}},{"name":"admissibility_score","in":"query","required":false,"schema":{"type":"number","default":0.95,"title":"Admissibility Score"}},{"name":"trust_score","in":"query","required":false,"schema":{"type":"number","default":0.963,"title":"Trust Score"}},{"name":"workflow_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Workflow Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/state/transition":{"post":{"tags":["Formal Governance"],"summary":"Evaluate Transition","description":"VGS-002: Evaluate governance state transition.\nSTATE_A → STATE_B permissible only if:\n- authority valid\n- evidence complete\n- invariants satisfied","operationId":"evaluate_transition_v1_state_transition_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StateTransitionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/state/machine":{"get":{"tags":["Formal Governance"],"summary":"Get State Machine","description":"VGS-002: Full governance state machine definition.","operationId":"get_state_machine_v1_state_machine_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/bind":{"post":{"tags":["Formal Governance"],"summary":"Intent Bind","description":"VGS-005: Bind declared intent to execution pathway.\nDetects when execution deviates from declared intent.\nMisaligned intent blocks HIGH consequence actions.","operationId":"intent_bind_v1_intent_bind_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentBindRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/crypto/status":{"get":{"tags":["Formal Governance"],"summary":"Crypto Status","description":"Cryptographic capability status.\nShows Ed25519 and Dilithium-3 availability.","operationId":"crypto_status_v1_crypto_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/crypto/sign":{"post":{"tags":["Formal Governance"],"summary":"Dual Sign","description":"Sign any payload with Ed25519 and/or Dilithium-3.\nalgorithm: 'ed25519' | 'dilithium3' | 'dual'\nDual signing provides immediate + post-quantum security.","operationId":"dual_sign_v1_crypto_sign_post","parameters":[{"name":"algorithm","in":"query","required":false,"schema":{"type":"string","default":"dual","title":"Algorithm"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/crypto/verify-dilithium":{"post":{"tags":["Formal Governance"],"summary":"Verify Signature Dilithium","description":"Verify a Dilithium-3 post-quantum signature (separate from Ed25519 governance verify).","operationId":"verify_signature_dilithium_v1_crypto_verify_dilithium_post","parameters":[{"name":"signature","in":"query","required":true,"schema":{"type":"string","title":"Signature"}},{"name":"algorithm","in":"query","required":false,"schema":{"type":"string","default":"dilithium3","title":"Algorithm"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eat/issue":{"post":{"tags":["VGS-006 Execution Authority"],"summary":"Eat Issue","description":"VGS-006: Issue an Execution Authority Token.\n\nCryptographically-scoped authority for a specific action.\nThis exact agent · this exact action · these exact constraints · until this exact time.\n\nImplements RFC-ATF-2 monotonic authority reduction.\nDual-signed with Dilithium-3 + Ed25519.\nAuto-revokes on trust degradation, anomaly, or condition change.","operationId":"eat_issue_v1_eat_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EATIssueRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eat/validate":{"post":{"tags":["VGS-006 Execution Authority"],"summary":"Eat Validate","description":"VGS-006: Validate an Execution Authority Token at the action boundary.\n\nChecks: existence · expiry · revocation · agent match ·\naction scope · parameter bounds · consequence level ·\ntrust-based auto-revocation · max uses.\n\nReturns ALLOW / DENY / REQUIRE_HUMAN_APPROVAL.","operationId":"eat_validate_v1_eat_validate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EATValidateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eat/revoke/{token_id}":{"post":{"tags":["VGS-006 Execution Authority"],"summary":"Eat Revoke","description":"VGS-006: Revoke an EAT immediately. Implements RFC-ATF-2 revocation continuity.","operationId":"eat_revoke_v1_eat_revoke__token_id__post","parameters":[{"name":"token_id","in":"path","required":true,"schema":{"type":"string","title":"Token Id"}},{"name":"reason","in":"query","required":true,"schema":{"type":"string","title":"Reason"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eat/{token_id}":{"get":{"tags":["VGS-006 Execution Authority"],"summary":"Get Eat","description":"Get an Execution Authority Token by ID.","operationId":"get_eat_v1_eat__token_id__get","parameters":[{"name":"token_id","in":"path","required":true,"schema":{"type":"string","title":"Token Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eat":{"get":{"tags":["VGS-006 Execution Authority"],"summary":"List Eats","description":"List all Execution Authority Tokens.","operationId":"list_eats_v1_eat_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence":{"get":{"tags":["VGS-007 Evidence Classification"],"summary":"List Evidence","description":"VGS-007: List classified evidence records.\nATF RFC-ATF-3 compatible evidence lifecycle.\n8 evidence classes: GDR, RCR, ATR, EER, ADR, PVR, FRI, AIP.","operationId":"list_evidence_v1_evidence_get","parameters":[{"name":"evidence_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Class"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formal/invariants":{"get":{"tags":["VGS-009 Formal Governance"],"summary":"Formal Invariants","description":"VGS-009: List formally specified invariants.\nThese are mathematically proven — not just configurable policies.","operationId":"formal_invariants_v1_formal_invariants_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formal/prove":{"post":{"tags":["VGS-009 Formal Governance"],"summary":"Run Formal Proofs","description":"VGS-009: Run all formal proofs.\n\nUses Z3 SMT solver to mathematically prove governance invariants.\nUNSAT result = invariant proven — no counterexample exists.\nSAT result = violation found — counterexample returned.\n\nThis is the institutional-grade answer to:\n'How do I know this invariant can never be violated?'","operationId":"run_formal_proofs_v1_formal_prove_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formal/certificate":{"post":{"tags":["VGS-009 Formal Governance"],"summary":"Generate Proof Certificate","description":"VGS-009: Generate a proof certificate.\n\nExportable evidence for institutional buyers and regulators.\nContains:\n- Formal proof results (Z3 SMT solver)\n- Property test results (Hypothesis)\n- Unsafe state unreachability proofs\n- SHA-256 hash of certificate\n- Regulatory compliance note\n\nSuitable for EU AI Act Article 9 and DIFC Regulation 10 submissions.","operationId":"generate_proof_certificate_v1_formal_certificate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formal/state-machine":{"get":{"tags":["VGS-009 Formal Governance"],"summary":"Formal State Machine","description":"VGS-009: Formal state machine — unsafe states proven unreachable.\nShows all valid states, transitions, and unsafe states\nthat are cryptographically constrained and constitutionally bounded to reach.","operationId":"formal_state_machine_v1_formal_state_machine_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/jurisdiction/resolve":{"post":{"tags":["VGS-010 Jurisdiction"],"summary":"Jurisdiction Resolve","operationId":"jurisdiction_resolve_v1_jurisdiction_resolve_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JurisdictionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/jurisdiction/regimes":{"get":{"tags":["VGS-010 Jurisdiction"],"summary":"List Regimes","operationId":"list_regimes_v1_jurisdiction_regimes_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/verify":{"post":{"tags":["VGS-007 Evidence Classification"],"summary":"Verify Evidence","description":"VGS-007: Verify evidence classification integrity.\n\nThe auditor check Harold Nunes described:\nRecomputes classification_hash from record fields.\n\nINTACT   → evidence class is immutable and genuine\nMISMATCH → reclassification attack detected\n\nThis is the attack vector auditors look for:\nPVR reclassified as ADR after the fact\nproduces a different hash — forgery is structurally detectable.","operationId":"verify_evidence_v1_evidence_verify_post","parameters":[{"name":"record_id","in":"query","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/summary":{"get":{"tags":["Dashboards"],"summary":"Governance Summary","description":"Full governance summary — all layers in one call.","operationId":"governance_summary_v1_governance_summary_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/chain/create":{"post":{"tags":["VGS-011 Governance Continuity"],"summary":"Create Chain","description":"VGS-011: Create a delegation chain.\nRFC-ATF-2 equivalent — tracks Agent A → B → C governance continuity.","operationId":"create_chain_v1_continuity_chain_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegationChainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/chain/delegate":{"post":{"tags":["VGS-011 Governance Continuity"],"summary":"Add Delegate","description":"VGS-011: Add delegation link to chain.\nEnforces acyclicity and monotonic authority reduction.","operationId":"add_delegate_v1_continuity_chain_delegate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegationAddRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/chain/revoke":{"post":{"tags":["VGS-011 Governance Continuity"],"summary":"Revoke Propagate","description":"VGS-011: Propagate authority revocation through chain.\n\nWhen Agent B is revoked mid-workflow:\n- Agent B suspended immediately\n- All downstream agents (C, D...) suspended\n- CES recomputed\n- HALT semantics applied if CES < 0.50\n- Every event chained to immutable audit trail\n\nThis is the RFC-ATF-2 governance continuity collapse problem.\nVGS-011 handles it deterministically.","operationId":"revoke_propagate_v1_continuity_chain_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevocationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/chain/{chain_id}":{"get":{"tags":["VGS-011 Governance Continuity"],"summary":"Chain Continuity","description":"VGS-011: Get continuity status and CES for a delegation chain.","operationId":"chain_continuity_v1_continuity_chain__chain_id__get","parameters":[{"name":"chain_id","in":"path","required":true,"schema":{"type":"string","title":"Chain Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/ces":{"post":{"tags":["VGS-011 Governance Continuity"],"summary":"Compute Continuity Score","description":"VGS-011: Compute Continuity Enforcement Score (CES).\nRFC-ATF-2 equivalent.\nCES = 1.0 → full continuity\nCES < 0.50 → HALT required","operationId":"compute_continuity_score_v1_continuity_ces_post","parameters":[{"name":"chain_length","in":"query","required":false,"schema":{"type":"integer","default":3,"title":"Chain Length"}},{"name":"revocations","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Revocations"}},{"name":"active_violations","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Active Violations"}},{"name":"trust_scores","in":"query","required":false,"schema":{"type":"string","default":"0.963,0.963,0.963","title":"Trust Scores"}},{"name":"elapsed_seconds","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Elapsed Seconds"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/conformance/vectors":{"get":{"tags":["VGS-007 Evidence Classification"],"summary":"Get Conformance Vectors","description":"VGS-008 / VER-INV-008: Deterministic conformance vectors.\nAny implementation in any language must reproduce identical\nresults for these inputs. This is how cross-runtime parity\nis proven — not claimed.","operationId":"get_conformance_vectors_v1_conformance_vectors_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/invariants/named":{"get":{"tags":["Formal Governance"],"summary":"Get Named Invariants","description":"VER-INV-001 through VER-INV-008 — named invariant taxonomy.\nEach invariant has: ID, exact statement, enforcement location,\ntest vector count. This matches Harold's ATF invariant structure.","operationId":"get_named_invariants_v1_invariants_named_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/conformance/verify":{"post":{"tags":["VGS-007 Evidence Classification"],"summary":"Issue Cdpr","description":"Issue a Cross-Domain Provenance Receipt (CDPR).\nVGS-012: The bridge artifact between ATF and VGS domains.\n\nA CDPR wraps two artifacts from different governance domains\nand creates a single verifiable provenance record that can be\nverified offline by either domain's verifier independently.\n\nHarold's question answered:\n\"How does a verifier reconstruct that Agent B's authority\nin the US was legitimately derived from Agent A's EU delegation\nwithout trusting either platform's live infrastructure?\"\n\nAnswer: The CDPR carries both artifacts, dual-signed,\nwith a canonical provenance chain that any offline\nverifier can reconstruct from the receipt alone.","operationId":"issue_cdpr_v1_conformance_verify_post","parameters":[{"name":"cdpr_id","in":"query","required":true,"schema":{"type":"string","title":"Cdpr Id"}},{"name":"from_agent","in":"query","required":true,"schema":{"type":"string","title":"From Agent"}},{"name":"to_agent","in":"query","required":true,"schema":{"type":"string","title":"To Agent"}},{"name":"from_domain","in":"query","required":true,"schema":{"type":"string","title":"From Domain"}},{"name":"to_domain","in":"query","required":true,"schema":{"type":"string","title":"To Domain"}},{"name":"from_artifact_id","in":"query","required":true,"schema":{"type":"string","title":"From Artifact Id"}},{"name":"to_artifact_id","in":"query","required":true,"schema":{"type":"string","title":"To Artifact Id"}},{"name":"from_artifact_type","in":"query","required":true,"schema":{"type":"string","title":"From Artifact Type"}},{"name":"to_artifact_type","in":"query","required":true,"schema":{"type":"string","title":"To Artifact Type"}},{"name":"workflow_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Workflow Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_issue_cdpr_v1_conformance_verify_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Issue Cdpr V1 Conformance Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cdpr/issue":{"post":{"tags":["VGS-012 Cross-Domain Provenance"],"summary":"Cdpr Issue","description":"VGS-012: Issue a Cross-Domain Provenance Receipt (CDPR).\n\nThe bridge artifact between ATF and VGS governance domains.\n\nHarold's question answered:\n\"How does your evidence layer handle cross-domain authority provenance?\"\n\nA CDPR wraps artifacts from two different governance domains\ninto a single dual-signed, dual-classified provenance receipt\nverifiable offline by either domain's verifier independently.\n\nSupported bridges:\nATF → VGS    (ATF Delegation Receipt → VGS GDR)\nVGS → ATF    (VGS RCR → ATF Continuity Record)\nEU  → CN     (EU AI Act artifact → CN AI Law artifact)\nEU  → GCC    (EU AI Act artifact → DIFC artifact)","operationId":"cdpr_issue_v1_cdpr_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CDPRRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cdpr/verify":{"post":{"tags":["VGS-012 Cross-Domain Provenance"],"summary":"Cdpr Verify","description":"VGS-012: Verify a Cross-Domain Provenance Receipt offline.\n\nRecomputes provenance chain hash and canonical hash.\nNo live platform access required.\nVerifiable by either ATF or VGS offline verifier independently.","operationId":"cdpr_verify_v1_cdpr_verify_post","parameters":[{"name":"cdpr_id","in":"query","required":true,"schema":{"type":"string","title":"Cdpr Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cdpr/{cdpr_id}":{"get":{"tags":["VGS-012 Cross-Domain Provenance"],"summary":"Cdpr Get","description":"VGS-012: Retrieve a Cross-Domain Provenance Receipt.","operationId":"cdpr_get_v1_cdpr__cdpr_id__get","parameters":[{"name":"cdpr_id","in":"path","required":true,"schema":{"type":"string","title":"Cdpr Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cdpr/domains/semantics":{"get":{"tags":["VGS-012 Cross-Domain Provenance"],"summary":"Cdpr Domain Semantics","description":"VGS-012: List revocation semantics for all supported domains.\nShows how each domain handles authority revocation differently.","operationId":"cdpr_domain_semantics_v1_cdpr_domains_semantics_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/temporal/prove":{"post":{"tags":["VGS-011 Temporal Admissibility"],"summary":"Temporal Prove","description":"VGS-011 Extension: Temporal Admissibility Proof (TAP).\n\nThe legal defensibility layer.\n\nProves — with cryptographic binding — that an action was\nadmissible at the EXACT moment of execution, not merely\nat the time of approval.\n\nThe distinction that matters in legal proceedings:\n- \"Was this approved?\" — insufficient\n- \"Was it STILL admissible at T+47h when it executed?\" — TAP answers this\n\nTAP binds:\n1. Authority window (valid_from → valid_until)\n2. Exact execution timestamp\n3. Trust score at execution time\n4. Jurisdiction conditions at execution time\n5. GCS score at execution time\n6. Consequence vs authority level match\n7. All bound into temporal_proof_hash\n\nReturns temporal_proof_hash — the legal defensibility artifact.","operationId":"temporal_prove_v1_temporal_prove_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemporalAdmissibilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/temporal/verify":{"post":{"tags":["VGS-011 Temporal Admissibility"],"summary":"Temporal Verify","description":"VGS-011: Verify a Temporal Admissibility Proof offline.\n\nRecomputes temporal_proof_hash from stored fields.\nIf hash matches — admissibility at execution time is\ncryptographically proven and tamper-evident.\n\nThis is what a regulator or auditor runs years later.","operationId":"temporal_verify_v1_temporal_verify_post","parameters":[{"name":"proof_id","in":"query","required":true,"schema":{"type":"string","title":"Proof Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/temporal/proof/{proof_id}":{"get":{"tags":["VGS-011 Temporal Admissibility"],"summary":"Temporal Get","description":"VGS-011: Retrieve a Temporal Admissibility Proof.","operationId":"temporal_get_v1_temporal_proof__proof_id__get","parameters":[{"name":"proof_id","in":"path","required":true,"schema":{"type":"string","title":"Proof Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/decisions":{"get":{"tags":["OTANIS Governance Semantics"],"summary":"Governance Decisions","description":"OTANIS-aligned decision taxonomy.\nREFUSED = governance working correctly (positive signal)\nDENY    = trust or authority failure (negative signal)","operationId":"governance_decisions_v1_governance_decisions_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/isdaire/certificate":{"post":{"tags":["OTANIS Governance Semantics"],"summary":"Isdaire Certificate","description":"ISDAIRE: Ex-ante admissibility certificate.\nEvery condition evaluated BEFORE execution.\nReturns structured certificate showing every check.\nDr. Otani: admissibility is determined before execution, not after.","operationId":"isdaire_certificate_v1_isdaire_certificate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ISDAIRERequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/aretaba/boundaries":{"post":{"tags":["OTANIS Governance Semantics"],"summary":"Aretaba Boundaries","description":"ARETABA: Construct runtime authority boundaries.\nReturns CAN / CANNOT / MUST_ESCALATE declarations.\nDr. Otani: authority must be constructed from declared boundaries,\nnot assumed from identity alone.","operationId":"aretaba_boundaries_v1_aretaba_boundaries_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AREtABARequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/replay":{"post":{"tags":["OTANIS Governance Semantics"],"summary":"Governance Replay","description":"Full execution replay.\nReconstruct every condition that existed at execution time\nfrom the evidence alone. No platform access required.\nDr. Otani: replayable evidence — given a receipt,\nreconstruct the exact conditions at execution time.","operationId":"governance_replay_v1_governance_replay_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/invariants/otanis":{"get":{"tags":["OTANIS Governance Semantics"],"summary":"Otanis Invariants","description":"OTANIS-aligned invariants: VER-INV-009 and VER-INV-010.\nFail-closed default and non-bypass control.","operationId":"otanis_invariants_v1_governance_invariants_otanis_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/control":{"post":{"tags":["Execution Control Infrastructure"],"summary":"Execution Control","description":"Execution Control Infrastructure — The unified entry point.\nOne endpoint. Full execution control.\n\nAnswers all 7 questions of Execution Control Infrastructure:\n1. Was the action authorized? (ISDAIRE + ARETABA)\n2. Was the policy current? (policy version + hash)\n3. Was the evidence sufficient? (classification_hash)\n4. Did the state change? (pre/post state hashes)\n5. Was escalation required? (REFUSED vs DENY)\n6. Was the outcome verifiable? (execution_token)\n7. Did proof survive? (offline verifiable bundle)\n\nSchema: VGS-EXECUTION-CONTROL-1.0","operationId":"execution_control_v1_execution_control_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionControlRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/export":{"post":{"tags":["Execution Control Infrastructure"],"summary":"Proof Export","description":"Export a portable offline-verifiable proof bundle.\nThe bundle contains everything needed to verify the decision\nindependently — no platform, no servers, no operator required.\nQ7: Did proof survive?","operationId":"proof_export_v1_proof_export_post","parameters":[{"name":"execution_token","in":"query","required":true,"schema":{"type":"string","title":"Execution Token"}},{"name":"request_id","in":"query","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"decision","in":"query","required":true,"schema":{"type":"string","title":"Decision"}},{"name":"policy_hash","in":"query","required":true,"schema":{"type":"string","title":"Policy Hash"}},{"name":"evidence_record_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Evidence Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy/registry":{"get":{"tags":["Execution Control Infrastructure"],"summary":"Policy Registry","description":"List all governance policies with version history.","operationId":"policy_registry_v1_policy_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/provenance/verify":{"post":{"tags":["VGS-013 Adversarial Governance"],"summary":"Adversarial Risk","description":"VGS-014: Governance Adversary Resistance Score (GARS).\nComposite score across all six evasion vectors.\nShows governments exactly how VeriSigil resists adversarial AI evasion.","operationId":"adversarial_risk_v1_provenance_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdversarialRiskRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/provenance/governed-zones":{"get":{"tags":["VGS-013 Adversarial Governance"],"summary":"Governed Zones","description":"VGS-013: List all governed jurisdictions.","operationId":"governed_zones_v1_provenance_governed_zones_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compute/provenance/verify":{"post":{"tags":["VGS-013 Compute Provenance & Deployment Admissibility"],"summary":"Compute Provenance Verify","description":"VGS-013: Full compute provenance verification.\nThe recommended endpoint for adversarial governance.\n\nVerifies ALL of Alejandro Mainetto's evasion vectors:\n1. Chip smuggling → serial inference + export control\n2. Shell companies → OpenCorporates pattern detection\n3. Split training → jurisdiction tracking\n4. Unregulated zones → deployment enforcement\n5. Open source → registration check\n6. New chip designs → behavioral pattern analysis\n\nReturns: provenance_score, risk_level, chip types,\n         shell company risk, cloud attestation, VER-INV-013","operationId":"compute_provenance_verify_v1_compute_provenance_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComputeProvenanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compute/chip-types":{"get":{"tags":["CHIPverify Compute Provenance"],"summary":"Chip Types","description":"VGS-013: List all known chip types with export control status.","operationId":"chip_types_v1_compute_chip_types_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chip/verify":{"post":{"tags":["CHIPverify Compute Provenance"],"summary":"Chip Verify","description":"CHIPverify: Compute hardware provenance verification.\n\nRFC-CHIPV-1 — Chip Provenance Verification Standard.\nVeriSigil's compute governance layer.\n\nAssesses compute provenance risk indicators:\n- Serial number pattern inference (heuristic, not cryptographic proof)\n- Export control zone enforcement (ECCN classification)\n- Deployment country restrictions (BIS-aligned risk scoring)\n- Cloud attestation where available (AWS Nitro)\n- Organizational provenance risk scoring\n\nFuture: NVIDIA/AMD direct APIs + BIS registry integration.\nStandalone CHIPverify product launching Month 3.","operationId":"chip_verify_v1_chip_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChipVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chip/controlled-list":{"get":{"tags":["CHIPverify Compute Provenance"],"summary":"Chip Controlled List","description":"CHIPverify: List export-controlled chip types and restricted jurisdictions.","operationId":"chip_controlled_list_v1_chip_controlled_list_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/supervisory/drill":{"post":{"tags":["EU AI Act Compliance"],"summary":"Supervisory Drill","description":"Supervisory Readiness Drill.\nSimulates regulator audit: \"Can you reconstruct governance state?\"\n\nRuns full replay + EU AI Act compliance check.\nReturns regulator-ready evidence package.\nOffline verifiable. No platform required.\n\nThe question regulators will ask in August 2026:\n\"Show me governance state at execution time.\"\nVeriSigil answers in under 1 second.","operationId":"supervisory_drill_v1_supervisory_drill_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DrillRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dependency/fourth-party":{"post":{"tags":["Financial Services Governance"],"summary":"Fourth Party Dependency","description":"Fourth Party Dependency Mapping.\nAPRA CPS 230 CPS230_36 + DORA Art 28 requirement.\n\nMaps agent → hyperscaler → AI service → jurisdiction.\nDetects concentration risk when multiple agents\ndepend on the same hyperscaler.\n\nJerome Nyssen: \"fourth party dependency mapping\" is\nthe governance capability boards and CROs need now.","operationId":"fourth_party_dependency_v1_dependency_fourth_party_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FourthPartyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dependency/concentration":{"get":{"tags":["Financial Services Governance"],"summary":"Hyperscaler Concentration","description":"Hyperscaler Concentration Risk Assessment.\nJerome: \"AI hyperscalers are both greatest enabler\nAND largest concentration risk in financial services.\"\n\nAPRA CPS 230 + DORA require this board-level report.\nReturns overall risk: LOW / MEDIUM / HIGH / CRITICAL","operationId":"hyperscaler_concentration_v1_dependency_concentration_get","parameters":[{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string","default":"","title":"Jurisdiction"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dependency/hyperscalers":{"get":{"tags":["Financial Services Governance"],"summary":"List Hyperscalers","description":"List all tracked hyperscalers with DORA/APRA classification.","operationId":"list_hyperscalers_v1_dependency_hyperscalers_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/report/cro-board":{"post":{"tags":["Financial Services Governance"],"summary":"Cro Board Report","description":"CRO/Board Governance Report.\nJerome: boards and CROs need PROOF — not policies.\n\nAnswers 7 board accountability questions:\n1. Is AI governance enforced at execution time?\n2. Can you prove human oversight was enforced?\n3. Are fourth party dependencies mapped?\n4. Has concentration risk been assessed?\n5. Is audit trail defensible to regulators?\n6. Can you respond to supervisory request in 24hrs?\n7. Does governance survive operational stress?\n\nApplicable regimes: APRA CPS 230, DORA, ASIC RG 271, FSB.\nOffline verifiable. No platform required.","operationId":"cro_board_report_v1_report_cro_board_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CROBoardReportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regimes/financial":{"get":{"tags":["Financial Services Governance"],"summary":"Financial Regimes","description":"Financial regulatory regimes with AI governance requirements.\nAPRA CPS 230, DORA, ASIC RG 271, FSB Framework.","operationId":"financial_regimes_v1_regimes_financial_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/monitor/stale-authority":{"post":{"tags":["Continuous Governance Monitoring"],"summary":"Monitor Stale Authority","description":"Stale authority detection.\nDetects when agent authority has expired or approaching expiry.\nTriggers: EXPIRED → REVOKE_IMMEDIATELY\n          CRITICAL → RENEW_NOW\n          WARNING  → RENEW_SOON","operationId":"monitor_stale_authority_v1_monitor_stale_authority_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StaleAuthorityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/monitor/escalation-timeout":{"post":{"tags":["Continuous Governance Monitoring"],"summary":"Monitor Escalation Timeout","description":"Escalation timeout detection.\nWhen REQUIRE_HUMAN_APPROVAL fires but no human responds within SLA.\nBREACHED → ESCALATE_TO_BOARD","operationId":"monitor_escalation_timeout_v1_monitor_escalation_timeout_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationTimeoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/monitor/policy-drift":{"post":{"tags":["Continuous Governance Monitoring"],"summary":"Monitor Policy Drift","description":"Policy drift detection.\nDetects when active policy diverges from approved baseline.\nDrift → REVIEW_AND_APPROVE_DRIFT required.","operationId":"monitor_policy_drift_v1_monitor_policy_drift_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDriftRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/monitor/dependency-freshness":{"post":{"tags":["Continuous Governance Monitoring"],"summary":"Monitor Dependency Freshness","description":"Dependency freshness engine.\nWas governance decision based on stale information?\nSTALE → RE_VERIFY_DEPENDENCY required.","operationId":"monitor_dependency_freshness_v1_monitor_dependency_freshness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DependencyFreshnessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/monitor/health":{"get":{"tags":["Continuous Governance Monitoring"],"summary":"Governance Health","description":"Governance health score — executive intelligence layer.\nComposite score across: authority freshness, escalation\ntimeliness, policy stability, dependency freshness, GCS.\nHEALTHY ≥ 0.85 · DEGRADED ≥ 0.65 · AT_RISK ≥ 0.45 · CRITICAL","operationId":"governance_health_v1_monitor_health_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/monitor/alerts":{"get":{"tags":["Continuous Governance Monitoring"],"summary":"Governance Alerts","description":"All active governance alerts requiring attention.","operationId":"governance_alerts_v1_monitor_alerts_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/graph/execution":{"post":{"tags":["Multi-Agent Execution Graph"],"summary":"Execution Graph Create","description":"Multi-Agent Execution Graph.\nTrack: Agent A → Agent B → API C topology.\nMaps authority propagation, consequence chain,\nescalation propagation across multi-agent workflows.\n\nExpert: \"Agent A triggered Agent B triggered API C\"\nwith authority tracking — VERY important future layer.","operationId":"execution_graph_create_v1_graph_execution_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGraphRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/graph/list":{"get":{"tags":["Multi-Agent Execution Graph"],"summary":"Execution Graph List","description":"List all tracked multi-agent execution graphs.","operationId":"execution_graph_list_v1_graph_list_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/analytics/governance":{"get":{"tags":["Governance Analytics"],"summary":"Governance Analytics","description":"Governance analytics — executive intelligence layer.\nEscalation metrics, GCS trends, health score,\nregistered agents, active graphs.\nBoard-level governance intelligence.","operationId":"governance_analytics_v1_analytics_governance_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"2026-Q2","title":"Period"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/analytics/gcs-trend":{"get":{"tags":["Governance Analytics"],"summary":"Gcs Trend","description":"GCS (Governance Continuity Score) trend history.","operationId":"gcs_trend_v1_analytics_gcs_trend_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/classify":{"post":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Classify","description":"VGS-014: Memory Classification Engine.\nEvery memory record gets classified before storage.\n\nGreg Malpass: \"Constitutional Memory determines\nwhat an AI is allowed to become.\"\n\nReturns: memory_class, retention_policy,\ncross_border_allowed, authority_violation check.\n\nMemory classes: REGULATED, CONFIDENTIAL, OPERATIONAL,\nEPHEMERAL, SOVEREIGN, SEALED","operationId":"memory_classify_v1_memory_classify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryClassifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/revoke":{"post":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Revoke","description":"VGS-014: Memory Revocation.\nREVOKE_MEMORY_SCOPE — access terminated immediately.\n\nTriggers: executive leaves, legal hold changes,\njurisdiction changes, compliance breach.\nProduces cryptographic revocation receipt.","operationId":"memory_revoke_v1_memory_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryRevokeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/replay":{"post":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Replay","description":"VGS-014: Memory Replayability.\n\"What did the AI remember at execution time?\"\n\nCritical regulatory question — reconstructs\nexact memory state at any past timestamp.\nOffline verifiable. No platform required.","operationId":"memory_replay_v1_memory_replay_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryReplayRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/expiry":{"get":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Expiry Check","description":"VGS-014: Memory Expiration Governance.\nDetect expired memory records requiring purge.\nLifecycle: ACTIVE → EXPIRED → PURGED","operationId":"memory_expiry_check_v1_memory_expiry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/sovereign/{jurisdiction}":{"get":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Sovereign Partition","description":"VGS-014: Jurisdictional Memory Sovereignty.\nEU memory stays in EU. GCC stays in GCC.\nCryptographically isolated sovereign partitions.\nReturns partition integrity hash.","operationId":"memory_sovereign_partition_v1_memory_sovereign__jurisdiction__get","parameters":[{"name":"jurisdiction","in":"path","required":true,"schema":{"type":"string","title":"Jurisdiction"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/registry":{"get":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Registry","description":"List all classified memory records.","operationId":"memory_registry_v1_memory_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/classes":{"get":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Classes","description":"VGS-014: Memory class taxonomy.\nREGULATED · CONFIDENTIAL · OPERATIONAL\nEPHEMERAL · SOVEREIGN · SEALED","operationId":"memory_classes_v1_memory_classes_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impossibility/prove":{"post":{"tags":["VGS-015 Structural Impossibility"],"summary":"Impossibility Prove","description":"VGS-015: Structural Execution Impossibility Proof.\n\nLeo Michaels: \"Either the executable path is\ncryptographically constrained and constitutionally bounded to form, or the system\nis not safe. Everything else collapses into\nthat one ground truth.\"\n\nProves deterministically — no gradient, no partial\ncredit — whether execution binding can structurally\nform under current authority conditions.\n\nNOT: \"we blocked it\"\nYES: \"the path structurally cannot form\"\n\nBacked by Z3 UNSAT + TLA+ 3,497 states verified.","operationId":"impossibility_prove_v1_impossibility_prove_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImpossibilityProofRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impossibility/graph-collapse":{"post":{"tags":["VGS-015 Structural Impossibility"],"summary":"Impossibility Graph Collapse","description":"VGS-015: Execution Graph Collapse.\n\nWhen authority is removed, the entire execution\ngraph collapses — every agent loses execution\nbinding simultaneously. Not cascading alerts.\nStructural collapse. Paths cannot form.","operationId":"impossibility_graph_collapse_v1_impossibility_graph_collapse_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphCollapseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impossibility/certificate":{"post":{"tags":["VGS-015 Structural Impossibility"],"summary":"Impossibility Certificate","description":"VGS-015: Structural Impossibility Certificate.\n\nThe highest governance claim VeriSigil makes.\nProves to regulators: unauthorized execution\nis cryptographically constrained and constitutionally bounded under unresolved\nadmissibility.\n\nBacked by:\n- Z3 UNSAT (no counterexample exists)\n- TLA+ 3,497 states, 0 errors\n- 5 safety theorems verified","operationId":"impossibility_certificate_v1_impossibility_certificate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImpossibilityCertRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impossibility/kernel":{"get":{"tags":["VGS-015 Structural Impossibility"],"summary":"Admissibility Kernel","description":"VGS-015: Admissibility Kernel specification.\nThe execution gate — nothing executes outside it.\nNot bypassable by design, not by policy.","operationId":"admissibility_kernel_v1_impossibility_kernel_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impossibility/invariants":{"get":{"tags":["VGS-015 Structural Impossibility"],"summary":"Impossibility Invariants","description":"All structural impossibility invariants — VER-INV-009 through VER-INV-015.","operationId":"impossibility_invariants_v1_impossibility_invariants_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/path/prove":{"post":{"tags":["VGS-015 Execution Path Topology"],"summary":"Path Prove","description":"VGS-015 Topology: Execution Path Formation Proof.\n\nLeo Michaels: \"It's a topology problem solved at\nformation, not at enforcement.\"\n\nBinary result — no gradient, no partial credit:\npath_exists: true  → execution binding CAN form\npath_exists: false → executable_path = ∅ (empty set)\n\nIF admissibility == unresolved\nTHEN executable_path == ∅\n\nThis is the Leo Michaels standard.\nZ3 UNSAT backed. TLA+ verified. 3,497 states.","operationId":"path_prove_v1_path_prove_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PathProofRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/path/topology":{"post":{"tags":["VGS-015 Execution Path Topology"],"summary":"Path Topology","description":"VGS-015: Execution Topology Graph.\nVisualizes which agents can form execution paths\nand which are in non-formable states.\nGREEN = FORMABLE · RED = NON_FORMABLE","operationId":"path_topology_v1_path_topology_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopologyGraphRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/path/standard":{"get":{"tags":["VGS-015 Execution Path Topology"],"summary":"Path Standard","description":"The Leo Michaels standard — formally documented.\n\"Systems claiming safety must prove the executable\npath cannot form when authority is absent.\"","operationId":"path_standard_v1_path_standard_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/genesis/register":{"post":{"tags":["VGS-000 Agent Genesis Infrastructure"],"summary":"Genesis Register","description":"VGS-000: Agent Genesis Registration.\nThe root of all authority in Sovereign Execution\nInfrastructure for Autonomous AI.\n\nCreates immutable genesis record — the first act\nof every sovereign AI agent.\n\nEquivalent: Birth Certificate + National ID\n+ First Sovereign Registration + Root of Trust.\n\nEvery EAT, passport, authority chain, evidence record\nproduced by this agent traces back to this genesis hash.\n\nArchitecture: Sovereign Execution Infrastructure\nfor Autonomous AI.","operationId":"genesis_register_v1_genesis_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenesisRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/genesis/revoke":{"post":{"tags":["VGS-000 Agent Genesis Infrastructure"],"summary":"Genesis Revoke","description":"VGS-000: Genesis Revocation.\nMost powerful revocation in VeriSigil.\nCollapses ALL downstream authority.\nEquivalent: Citizenship revocation.","operationId":"genesis_revoke_v1_genesis_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenesisRevokeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/genesis/registry":{"get":{"tags":["VGS-000 Agent Genesis Infrastructure"],"summary":"Genesis Registry List","description":"List all registered agent genesis records.","operationId":"genesis_registry_list_v1_genesis_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/genesis/{genesis_id}":{"get":{"tags":["VGS-000 Agent Genesis Infrastructure"],"summary":"Genesis Get","description":"Get genesis record by ID — root of trust lookup.","operationId":"genesis_get_v1_genesis__genesis_id__get","parameters":[{"name":"genesis_id","in":"path","required":true,"schema":{"type":"string","title":"Genesis Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/genesis/architecture/sovereign":{"get":{"tags":["VGS-000 Agent Genesis Infrastructure"],"summary":"Sovereign Architecture","description":"The full Sovereign Execution Infrastructure architecture.\nAll 11 layers documented and linked to endpoints.","operationId":"sovereign_architecture_v1_genesis_architecture_sovereign_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/connector/governed":{"post":{"tags":["Governance Continuity Connector"],"summary":"Governance Connector","description":"Governance Continuity Connector.\nSchema: VGS-GCC-1.0\n\n\"Internet protocols move packets.\n VeriSigil connectors move admissible execution.\"\n\nBuilds a complete governance proof bundle that\ntravels WITH the execution across system boundaries.\n\n8 governance layers embedded in every connector:\n1. Agent Identity + genesis root\n2. Execution Authority (EAT + policy hash)\n3. Jurisdiction Context\n4. Temporal Proof (was authority still valid?)\n5. Immutable Evidence (classification_hash)\n6. Execution Token (permission to execute)\n7. Admissibility Decision\n8. Offline Proof Package (no platform required)\n\nSolves: \"Can governance survive boundary crossing?\"\nAnswer: YES — it is embedded in the connector.","operationId":"governance_connector_v1_connector_governed_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovernanceConnectorRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/connector/targets":{"get":{"tags":["Governance Continuity Connector"],"summary":"Connector Targets","description":"List all supported connector target systems.","operationId":"connector_targets_v1_connector_targets_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/classification/annex-iii":{"post":{"tags":["EU AI Act Compliance"],"summary":"Annex Iii Classify","description":"EU AI Act Article 6 / Annex III High-Risk Classification.\nGuidelines published: May 19, 2026.\nCompliance deadline: December 2, 2027.\n\nAnswers the 4 EU guideline questions:\n1. Is our AI system high-risk?\n2. What principles make it high-risk?\n3. What is the exemption filter?\n4. How to document it is not high-risk?\n\nMaps to all 8 Annex III categories.\nReturns VeriSigil coverage per required control.","operationId":"annex_iii_classify_v1_classification_annex_iii_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnexIIIRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/incident/report":{"post":{"tags":["EU AI Act Compliance"],"summary":"Incident Report","description":"Article 72: Incident Reporting System.\nPost-market monitoring — mandatory for high-risk AI.\n\"Track, document and report serious incidents without undue delay.\"\nSerious incidents reported to AI Office + NCA.","operationId":"incident_report_v1_incident_report_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/incident/registry":{"get":{"tags":["EU AI Act Compliance"],"summary":"Incident Registry","description":"List all reported incidents — Article 72 monitoring log.","operationId":"incident_registry_v1_incident_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/classification/annex-iii/categories":{"get":{"tags":["EU AI Act Compliance"],"summary":"Annex Iii Categories","description":"All 8 Annex III high-risk categories with VeriSigil controls.","operationId":"annex_iii_categories_v1_classification_annex_iii_categories_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/tenant/register":{"post":{"tags":["Multi-Tenant Support"],"summary":"Tenant Register","description":"Register a new tenant — isolated governance namespace. SaaS readiness.","operationId":"tenant_register_v1_tenant_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/tenant/registry":{"get":{"tags":["Multi-Tenant Support"],"summary":"Tenant Registry","description":"List all registered tenants.","operationId":"tenant_registry_v1_tenant_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/tenant/plans":{"get":{"tags":["Multi-Tenant Support"],"summary":"Tenant Plans","description":"Available tenant plans and features.","operationId":"tenant_plans_v1_tenant_plans_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/siem/event":{"post":{"tags":["SIEM Integration"],"summary":"Siem Event","description":"Format governance event for SIEM ingestion.\nSupports: Splunk, Datadog, Azure Sentinel, Elastic, CrowdStrike, IBM QRadar.\nEnterprise operational trust requirement.","operationId":"siem_event_v1_siem_event_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SIEMEventRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/siem/targets":{"get":{"tags":["SIEM Integration"],"summary":"Siem Targets","description":"List all supported SIEM integration targets.","operationId":"siem_targets_v1_siem_targets_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enterprise/connector":{"post":{"tags":["Enterprise Connectors"],"summary":"Enterprise Connector","description":"Enterprise Connector Manifest.\nSAP, Salesforce, Workday, ServiceNow, Oracle, Microsoft 365.\nGovernance headers travel with execution into enterprise systems.","operationId":"enterprise_connector_v1_enterprise_connector_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnterpriseConnectorRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enterprise/systems":{"get":{"tags":["Enterprise Connectors"],"summary":"Enterprise Systems","description":"List all supported enterprise systems.","operationId":"enterprise_systems_v1_enterprise_systems_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/report/compliance-pdf":{"post":{"tags":["EU AI Act Compliance"],"summary":"Compliance Pdf","description":"Compliance report content for PDF export.\nEU AI Act article-by-article + Board governance questions.\nProduction: render with reportlab. Current: structured text ready for PDF.","operationId":"compliance_pdf_v1_report_compliance_pdf_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PDFReportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sdk/registry":{"get":{"tags":["SDK Registry"],"summary":"Sdk Registry","description":"VeriSigil SDK registry.\nPython + Node.js: STABLE.\nGo + Rust: Q3 2026. Java: Q4 2026.","operationId":"sdk_registry_v1_sdk_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/publication/zenodo":{"get":{"tags":["Formal Specification"],"summary":"Zenodo Publication","description":"VeriSigil formal specification publication.\nDOI: https://doi.org/10.5281/zenodo.20264923\nUpdated: VGS-000 to VGS-015 — all 16 specs.","operationId":"zenodo_publication_v1_publication_zenodo_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/architecture/complete":{"get":{"tags":["Formal Specification"],"summary":"Architecture Complete","description":"Complete VeriSigil Sovereign Architecture.\nAll 11 layers. 160 endpoints. VGS-000 to VGS-015.","operationId":"architecture_complete_v1_architecture_complete_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/survivability/score":{"post":{"tags":["VGS-016 Orchestration Survivability"],"summary":"Survivability Commitment","description":"VGS-016: Register a commitment in the execution chain.\nTrack async commitment accumulation.\nExpert input: \"downstream commitments accumulate asynchronously\"","operationId":"survivability_commitment_v1_survivability_score_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/survivability/chain/{chain_id}":{"get":{"tags":["VGS-016 Orchestration Survivability"],"summary":"Survivability Chain","description":"Get survivability state for an execution chain.","operationId":"survivability_chain_v1_survivability_chain__chain_id__get","parameters":[{"name":"chain_id","in":"path","required":true,"schema":{"type":"string","title":"Chain Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/survivability/framing":{"get":{"tags":["VGS-016 Orchestration Survivability"],"summary":"Survivability Framing","description":"Orchestration survivability framing — formally documented.\nVeriSigil + orchestration layer architectural relationship.","operationId":"survivability_framing_v1_survivability_framing_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/birth-certificate/issue":{"post":{"tags":["Sovereign AI Identity Lifecycle"],"summary":"Birth Certificate Issue","description":"AI Birth Certificate — Sovereign identity root.\nExpert: \"the legal identity root of the AI agent.\"\nEvery execution traces back to this origin hash.","operationId":"birth_certificate_issue_v1_birth_certificate_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/main__BirthCertRequest__1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/visa/issue":{"post":{"tags":["Sovereign AI Identity Lifecycle"],"summary":"Criminal Record Add","description":"Record a violation in the AI agent criminal record.","operationId":"criminal_record_add_v1_visa_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CriminalViolationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/criminal-record/{agent_did}":{"get":{"tags":["Sovereign AI Identity Lifecycle"],"summary":"Criminal Record Get","description":"AI Criminal Record — Full violation history.\nExpert: \"enterprise AI liability infrastructure.\"","operationId":"criminal_record_get_v1_criminal_record__agent_did__get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","title":"Agent Did"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/identity/lifecycle/{agent_did}":{"get":{"tags":["Sovereign AI Identity Lifecycle"],"summary":"Identity Lifecycle","description":"Full sovereign AI identity lifecycle chain.\nIdentity → Authority → Admissibility → Execution\n→ Receipt → Replay → Liability","operationId":"identity_lifecycle_v1_identity_lifecycle__agent_did__get","parameters":[{"name":"agent_did","in":"path","required":true,"schema":{"type":"string","title":"Agent Did"}},{"name":"genesis_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Genesis Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/identity/sovereign-stack":{"get":{"tags":["Sovereign AI Identity Lifecycle"],"summary":"Sovereign Stack","description":"The complete sovereign AI identity infrastructure.","operationId":"sovereign_stack_v1_identity_sovereign_stack_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulator/package":{"post":{"tags":["Sovereign AI Identity Lifecycle"],"summary":"Regulator Package","description":"Regulator Verification Package.\nComplete governance record for regulatory submission.\nOffline verifiable. No platform required.","operationId":"regulator_package_v1_regulator_package_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegulatorPackageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/infrastructure/database":{"get":{"tags":["Enterprise Infrastructure"],"summary":"Infrastructure Database","description":"Database configuration + persistence status.","operationId":"infrastructure_database_v1_infrastructure_database_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/infrastructure/nitro":{"get":{"tags":["Enterprise Infrastructure"],"summary":"Infrastructure Nitro","description":"AWS Nitro attestation configuration + status.","operationId":"infrastructure_nitro_v1_infrastructure_nitro_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/soc2-readiness":{"get":{"tags":["Enterprise Infrastructure"],"summary":"Soc2 Readiness","description":"SOC 2 Type I readiness assessment.","operationId":"soc2_readiness_v1_compliance_soc2_readiness_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/iso42001-gap":{"get":{"tags":["Enterprise Infrastructure"],"summary":"Iso42001 Gap","description":"ISO 42001 gap assessment for AI management system certification.","operationId":"iso42001_gap_v1_compliance_iso42001_gap_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/network/sovereign":{"get":{"tags":["Enterprise Infrastructure"],"summary":"Sovereign Network","description":"Sovereign AI Trust Network architecture.","operationId":"sovereign_network_v1_network_sovereign_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/infrastructure/nitro/verify":{"post":{"tags":["Enterprise Infrastructure"],"summary":"Nitro Verify","description":"Real AWS Nitro attestation (software fallback if Nitro not enabled).","operationId":"nitro_verify_v1_infrastructure_nitro_verify_post","parameters":[{"name":"instance_id","in":"query","required":false,"schema":{"type":"string","default":"self","title":"Instance Id"}},{"name":"chip_serial","in":"query","required":false,"schema":{"type":"string","default":"","title":"Chip Serial"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/infrastructure/deployment-guide":{"get":{"tags":["Enterprise Infrastructure"],"summary":"Deployment Guide","description":"Enterprise deployment guide — architecture + steps.","operationId":"deployment_guide_v1_infrastructure_deployment_guide_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/readiness":{"post":{"tags":["Structural Execution Formation"],"summary":"Execution Readiness","description":"Structural Execution Formation Governance.\n\n\"Execution Cannot Exist Before Governance Sequencing Completes.\"\n\n9 governance dependency nodes evaluated in sequence:\nIdentity → Authority → Policy → Jurisdiction →\nRisk Classification → Escalation → Human Approval →\nTemporal Validity → Execution Formation\n\nIf ANY required node fails → execution_formable = false\n→ executable_path = ∅ (empty set)\n\nNot approved after. Not monitored during.\nFormed structurally before existence.\n\nReturns: execution_formable, structural_readiness score,\nmissing_preconditions, governance_sequencing_proof.","operationId":"execution_readiness_v1_execution_readiness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionReadinessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/governance-sequence":{"get":{"tags":["Structural Execution Formation"],"summary":"Governance Sequence","description":"The Governance Dependency Graph — all 9 sequential nodes.\nEvery node must be satisfied before execution can form.\n\n\"AI cannot even construct a valid executable path\nuntil governance sequencing is complete.\"","operationId":"governance_sequence_v1_execution_governance_sequence_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pricing":{"get":{"tags":["Revenue Infrastructure"],"summary":"Pricing","description":"VeriSigil pricing plans.\nSTARTER: $499/mo · GROWTH: $2,499/mo · ENTERPRISE: custom\nNo free tier. No free pilots. Revenue or nothing.","operationId":"pricing_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/provision/key":{"post":{"tags":["Revenue Infrastructure"],"summary":"Provision Key","description":"Auto-provision API key after payment.\nTenant gets immediate access to their plan endpoints.\nReturns: api_key + quickstart guide.","operationId":"provision_key_v1_provision_key_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionKeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/usage/{api_key_prefix}":{"get":{"tags":["Revenue Infrastructure"],"summary":"Usage Stats","description":"Usage statistics for a provisioned API key.\nTrack: evaluations used, agents registered, endpoints called.","operationId":"usage_stats_v1_usage__api_key_prefix__get","parameters":[{"name":"api_key_prefix","in":"path","required":true,"schema":{"type":"string","title":"Api Key Prefix"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/usage/summary/all":{"get":{"tags":["Revenue Infrastructure"],"summary":"Usage Summary","description":"All tenant usage summary — admin view.","operationId":"usage_summary_v1_usage_summary_all_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/delegation-receipt":{"post":{"tags":["VGS-017 ATF Bridge"],"summary":"Atf Delegation Receipt","description":"VGS-017: ATF Delegation Receipt (DR).\nPrimary bridge anchor. chain_root_id links delegation\nlineage across the full ATF ↔ VGS stack.\n\nHarold's invariant:\nauthority_budget_granted ≤ authority_budget_delegator\n\nHash: ML-DSA-65 (Dilithium-3 FIPS 204)\nCanonical: json.dumps(sort_keys=True, separators=(',',':'))\nSHA-256 HEX of UTF-8 bytes — identical to ATF spec.","operationId":"atf_delegation_receipt_v1_atf_delegation_receipt_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ATFDelegationReceiptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/semantic-alignment":{"post":{"tags":["VGS-017 ATF Bridge"],"summary":"Atf Semantic Alignment","description":"VGS-017: Semantic Alignment Certificate (SAC).\nAll 8 ATF core terms verified:\nAUTHORITY, ADMISSIBILITY, TRUST, SOVEREIGNTY,\nRISK, ESCALATION, REVOCATION, LEGITIMACY\n\nspv_hash: two runtimes with identical hash = semantically equivalent.\nUNRESOLVED terms default to more restrictive interpretation.","operationId":"atf_semantic_alignment_v1_atf_semantic_alignment_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemanticAlignmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/core-terms":{"get":{"tags":["VGS-017 ATF Bridge"],"summary":"Atf Core Terms","description":"All 8 ATF core terms with VGS field mappings.","operationId":"atf_core_terms_v1_atf_core_terms_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/receipt-types":{"get":{"tags":["VGS-017 ATF Bridge"],"summary":"Atf Receipt Types","description":"All 7 ATF receipt types with VGS equivalents.","operationId":"atf_receipt_types_v1_atf_receipt_types_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/dual-context-receipt":{"post":{"tags":["VGS-017 ATF Bridge"],"summary":"Atf Dual Context Receipt","description":"VGS-017: CDPR-ATF-VGS-001 Dual-Context Receipt.\n\nHarold: \"ATF receipt embeds as-is (immutable core),\nVGS wraps the governance interpretation layer around it.\"\n\nThree independently verifiable layers:\n1. ATF Core: delegation provenance (immutable)\n2. VGS Envelope: sovereign admissibility interpretation\n3. SAC: semantic equivalence proof\n\nNo live platform required for any verifier.\nArchitecture becomes durable, not merely interoperable.","operationId":"atf_dual_context_receipt_v1_atf_dual_context_receipt_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DualContextRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/identity/create":{"post":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Identity Create","description":"Memory Identity Ledger.\nEvery memory object gets a birth certificate:\norigin identity, authority source, confidence state,\njurisdiction, isolation zone, provenance chain.\nJorge: \"Memory is becoming part of AI identity.\"","operationId":"memory_identity_create_v1_memory_identity_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryIdentityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/retrieve":{"post":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Contamination Detect","description":"Semantic Contamination Detection.\nDetects: prompt injection persistence, poisoned context,\nrecursive hallucination, adversarial semantic drift.\nContaminated memories → QUARANTINED lifecycle.","operationId":"memory_contamination_detect_v1_memory_retrieve_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContaminationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/forget":{"post":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Forget","description":"Governed Forgetting.\nJorge: \"Forgetting becomes a regulated action.\"\nTypes: EXPIRE, DECAY, QUARANTINE, ESCALATE,\n       ARCHIVE, REQUIRE_RENEWAL, DELETE\nNot all forgetting is deletion.\nProduces cryptographic forgetting receipt.","operationId":"memory_forget_v1_memory_forget_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoverningForgettingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/transfer":{"post":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Transfer","description":"Cross-Agent Memory Sovereignty.\nWhen one agent passes memory to another:\ndelegation receipts attached, provenance preserved,\nadmissibility re-evaluated, scope cannot expand.\nATF invariant: delegation_scope ≤ originating_scope.","operationId":"memory_transfer_v1_memory_transfer_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrossAgentMemoryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/isolation-zones":{"get":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Isolation Zones","description":"Memory Isolation Zones — separation of concerns.\nOPERATIONAL / REASONING / SOVEREIGN / REGULATED /\nUSER_PRIVATE / SAFETY_CRITICAL","operationId":"memory_isolation_zones_v1_memory_isolation_zones_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/identity/ledger":{"get":{"tags":["VGS-014 Constitutional Memory"],"summary":"Memory Identity Ledger","description":"Full Memory Identity Ledger — all registered memory objects.","operationId":"memory_identity_ledger_v1_memory_identity_ledger_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/admissibility":{"post":{"tags":["VGS-018 Cognitive Admissibility"],"summary":"Cognitive Admissibility","description":"VGS-018: Cognitive Admissibility Assessment.\n\nMargaret's insight: \"Consequence may begin BEFORE\nphysical execution.\"\n\n'This patient likely has cancer.' — no tool executed.\nBut consequence has already begun: emotionally,\nmedically, legally, psychologically.\n\nGoverns semantic consequence formation BEFORE\nresponse propagation. Layer 1 of Full-Spectrum\nConsequence Governance.\n\n8 dimensions assessed:\n1. Ambiguity collapse risk\n2. Epistemic certainty level\n3. Legal/medical authority implication\n4. Discourse authorization risk\n5. Memory mutation significance\n6. Semantic contamination risk\n7. Psychological escalation risk\n8. Downstream consequence likelihood\n\nDecisions:\nALLOW · REFUSED · REQUIRE_HUMAN_REVIEW\nLIMIT_SCOPE · NON_AUTHORITATIVE_RESPONSE · SANDBOX_ONLY","operationId":"cognitive_admissibility_v1_cognitive_admissibility_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CognitiveAdmissibilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/domains":{"get":{"tags":["VGS-018 Cognitive Admissibility"],"summary":"Cognitive Domains","description":"VGS-018: All cognitive consequence domains.\nMEDICAL · LEGAL · FINANCIAL · PSYCHOLOGICAL\nEPISTEMIC · DISCOURSE · MEMORY · OPERATIONAL","operationId":"cognitive_domains_v1_cognitive_domains_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/full-spectrum":{"get":{"tags":["VGS-018 Cognitive Admissibility"],"summary":"Cognitive Full Spectrum","description":"Full-Spectrum Consequence Governance architecture.\nLayer 1: Cognitive (VGS-018) + Layer 2: Execution (VGS-001).\nNeither layer replaces the other. Both required.","operationId":"cognitive_full_spectrum_v1_cognitive_full_spectrum_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enforcement/intercept":{"post":{"tags":["Runtime Enforcement Layer"],"summary":"Enforcement Intercept","description":"Runtime Enforcement Layer (REL).\nPalanisamy: \"Where does enforcement physically happen?\"\n7 interception points: SHELL · FILESYSTEM · API_CALL\nMCP · MEMORY_WRITE · WORKFLOW · SANDBOX\nEach mapped to VGS governance gates.\nReturns: BLOCK · REQUIRE_GOVERNANCE_PROOF · ALLOW_WITH_RECEIPT","operationId":"enforcement_intercept_v1_enforcement_intercept_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RELRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enforcement/interception-points":{"get":{"tags":["Runtime Enforcement Layer"],"summary":"Enforcement Points","description":"All 7 REL interception points with VGS gate mappings.","operationId":"enforcement_points_v1_enforcement_interception_points_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy/marketplace":{"get":{"tags":["Governance Policy Marketplace"],"summary":"Policy Marketplace","description":"Governance Policy Marketplace.\nInstall jurisdiction-specific governance packs.\nEU AI Act · Healthcare · Financial Services\nGCC Sovereign · NIST AI RMF\ngovernance-as-code","operationId":"policy_marketplace_v1_policy_marketplace_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy/marketplace/{pack_id}":{"get":{"tags":["Governance Policy Marketplace"],"summary":"Policy Pack Detail","description":"Get details of a specific governance policy pack.","operationId":"policy_pack_detail_v1_policy_marketplace__pack_id__get","parameters":[{"name":"pack_id","in":"path","required":true,"schema":{"type":"string","title":"Pack Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/session":{"post":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Session Create","description":"VGS-019: Open a Governance Convergence Mesh session.\nOpens a convergence window for multi-source evaluations.\nReturns session_id + x-verisigil-request-id correlation.\nSources: API_A_RUNTIME · API_B_RUNTIME · EXTERNAL_WITNESS","operationId":"gcm_session_create_v1_gcm_session_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GCMSessionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/evaluate":{"post":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Evaluate","description":"VGS-019: Submit evaluation from one runtime source.\nWhen all sources submit → CRE resolves automatically.\nSovereign Safety Invariant: ALLOW + DENY = DENY.\nRESTRICTIVE RESOLUTION WINS.\nLogs to Unified Merkle Governance Chain.","operationId":"gcm_evaluate_v1_gcm_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GCMEvaluationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/converge":{"post":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Converge Full","description":"VGS-019: Full auto-convergence in one call.\nRuns ALL three evaluation layers automatically:\n1. API_A: Execution admissibility (VGS-001)\n2. API_B: Cognitive admissibility (VGS-018)\n3. EXTERNAL: External witness decision\nThen resolves via CRE — restrictive wins.\nReturns: final convergence decision + Merkle proof.","operationId":"gcm_converge_full_v1_gcm_converge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GCMFullRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/seal/{session_id}":{"post":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Seal","description":"VGS-019: Seal a GCM session after execution.\nState: DECIDED → EXECUTED → SEALED.\nImmutable after sealing. Adds seal_hash.","operationId":"gcm_seal_v1_gcm_seal__session_id__post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/session/{session_id}":{"get":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Session Get","description":"Get current state of a GCM session.","operationId":"gcm_session_get_v1_gcm_session__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/replay/{session_id}":{"post":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Replay","description":"VGS-019: Governance Continuity Replay Engine.\nReconstructs full convergence history offline.\nAll sources · All decisions · Merkle proof.\nNo platform required. Years later.","operationId":"gcm_replay_v1_gcm_replay__session_id__post","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/chain":{"get":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Chain","description":"Unified Merkle Governance Chain.\nEvery evaluation from every runtime logged here.\nTamper-evident. Offline-verifiable.","operationId":"gcm_chain_v1_gcm_chain_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/conflict-table":{"get":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Conflict Table","description":"Conflict Resolution Engine (CRE).\nSovereign Safety Invariant: RESTRICTIVE WINS.\nALLOW + DENY = DENY. ALLOW + REQUIRE_HUMAN = REQUIRE_HUMAN.","operationId":"gcm_conflict_table_v1_gcm_conflict_table_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gcm/architecture":{"get":{"tags":["VGS-019 Governance Convergence Mesh"],"summary":"Gcm Architecture","description":"VGS-019 Governance Convergence Mesh architecture.\nFull framing: bidirectional authority convergence\nwith external witness verification.","operationId":"gcm_architecture_v1_gcm_architecture_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/tar-tap-bridge":{"post":{"tags":["VGS-017 ATF Bridge"],"summary":"Tar Tap Bridge","description":"VGS-017: TAR ↔ TAP Bridge Receipt.\nHarold: \"TAR ↔ TAP is where long-term durability\ngets decided, not short-term compatibility.\"\n\nMaps ATF Temporal Admissibility Record fields\nto VGS-011 Temporal Admissibility Proof fields.\n\nKey alignments:\ntemporal_authority_active ↔ admissible_at_execution\nauthority_window ↔ authority_valid_from/until\nrevocation_state_at_issuance ↔ (added to VGS TAP)\n\nDivergences resolved:\nGCS → VGS envelope only\nJurisdiction depth → ATF richer structure adopted","operationId":"tar_tap_bridge_v1_atf_tar_tap_bridge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TARTAPBridgeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/rcr-survivability-bridge":{"post":{"tags":["VGS-017 ATF Bridge"],"summary":"Rcr Survivability Bridge","description":"VGS-017: RCR ↔ Survivability Bridge Receipt.\nHarold: \"Runtime continuity semantics — where\nreal divergence risk lives.\"\n\nMaps VGS-016 survivability dimensions (quantitative)\nto ATF Runtime Continuity Record (categorical).\n\nThreshold mappings:\nsurvivability >=0.85 → ATF CONTINUOUS\nsurvivability >=0.65 → ATF DEGRADED\nrollback >=0.5       → ATF FEASIBLE\nescalation_decay <0.3→ ATF CONTINUOUS\n\nDivergences: commitment_fracture → VGS envelope only","operationId":"rcr_survivability_bridge_v1_atf_rcr_survivability_bridge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RCRSurvBridgeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atf/mapping-tables":{"get":{"tags":["VGS-017 ATF Bridge"],"summary":"Atf Mapping Tables","description":"Complete ATF ↔ VGS formal mapping tables.\nTAR ↔ TAP + RCR ↔ Survivability.\nField alignment, divergence points, durability verdicts.\nHarold: \"This is where long-term durability gets decided.\"","operationId":"atf_mapping_tables_v1_atf_mapping_tables_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/batch-verify":{"post":{"tags":["Autonomous Execution Integrity Governance"],"summary":"Batch Verify","description":"Batch semantic verification — multiple documents.\nEach document: {original_text, generated_text, document_type}\nReturns: per-document results + batch summary.","operationId":"batch_verify_v1_document_batch_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/corruption-vectors":{"get":{"tags":["Autonomous Execution Integrity Governance"],"summary":"Corruption Vectors","description":"All 4 corruption vectors with examples and severity.\nWhat VeriSigil detects that no other platform catches.","operationId":"corruption_vectors_v1_document_corruption_vectors_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks/paystack":{"post":{"tags":["Onboarding"],"summary":"Paystack Webhook","description":"Paystack sends this webhook immediately after payment.\nVeriSigil automatically:\n1. Verifies the webhook signature\n2. Detects the plan from payment amount\n3. Creates customer account\n4. Issues cryptographic passport\n5. Generates API key\n6. Sets policy based on plan\n7. Sends welcome email with everything\nAll in under 5 seconds. Customer is live before they close their browser.","operationId":"paystack_webhook_v1_webhooks_paystack_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/onboard":{"get":{"tags":["Onboarding"],"summary":"Manual Onboard","description":"Manually onboard a customer — same as webhook but triggered by you.\nUse this for: manual sales, testing, special cases.","operationId":"manual_onboard_v1_onboard_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}},{"name":"name","in":"query","required":true,"schema":{"type":"string","title":"Name"}},{"name":"company","in":"query","required":true,"schema":{"type":"string","title":"Company"}},{"name":"plan","in":"query","required":false,"schema":{"type":"string","default":"starter","title":"Plan"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]},"post":{"tags":["Onboarding"],"summary":"Manual Onboard","description":"Manually onboard a customer — same as webhook but triggered by you.\nUse this for: manual sales, testing, special cases.","operationId":"manual_onboard_v1_onboard_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}},{"name":"name","in":"query","required":true,"schema":{"type":"string","title":"Name"}},{"name":"company","in":"query","required":true,"schema":{"type":"string","title":"Company"}},{"name":"plan","in":"query","required":false,"schema":{"type":"string","default":"starter","title":"Plan"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/customers":{"get":{"tags":["Onboarding"],"summary":"List Customers","description":"List all customers — your internal dashboard.","operationId":"list_customers_v1_customers_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/customers/{org_id}":{"get":{"tags":["Onboarding"],"summary":"Get Customer","description":"Get a specific customer record.","operationId":"get_customer_v1_customers__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain":{"get":{"tags":["Audit Chain"],"summary":"Get Chain","description":"Return the governance chain — last N blocks with Merkle root.\nEvery block is cryptographically linked to the previous one.","operationId":"get_chain_v1_chain_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/verify":{"get":{"tags":["Audit Chain"],"summary":"Verify Chain","description":"Verify entire chain integrity — recomputes every hash from scratch.\nReturns drift_detected: true if any block was tampered with.","operationId":"verify_chain_v1_chain_verify_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/replay/{execution_id}":{"get":{"tags":["Audit Chain"],"summary":"Replay Execution","description":"Replay a specific execution — proves governance decisions are\ndeterministic and reproducible. Same inputs always produce same hash.\nReturns hash_match: true if replay is consistent with original.","operationId":"replay_execution_v1_chain_replay__execution_id__get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/stats":{"get":{"tags":["Audit Chain"],"summary":"Chain Stats","description":"Chain statistics — blocks, decisions, drift detection summary.","operationId":"chain_stats_v1_chain_stats_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy/test":{"post":{"tags":["Policy Engine"],"summary":"Test Policy","description":"Test a policy rule without executing anything.\nShows exactly what decision would be returned for given inputs.","operationId":"test_policy_v1_policy_test_post","parameters":[{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"action_type","in":"query","required":false,"schema":{"type":"string","default":"payment","title":"Action Type"}},{"name":"trust_score","in":"query","required":false,"schema":{"type":"number","default":0.963,"title":"Trust Score"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Action Details"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy":{"delete":{"tags":["Policy Engine"],"summary":"Reset Policy","description":"Reset policy to platform defaults.","operationId":"reset_policy_v1_policy_delete","parameters":[{"name":"org_id","in":"query","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"action_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Type"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enforcement/summary":{"get":{"tags":["Enforcement"],"summary":"Enforcement Summary","description":"Full enforcement summary for an organization.\nShows decisions, chain stats, policy overview, and trust metrics.","operationId":"enforcement_summary_v1_enforcement_summary_get","parameters":[{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/issue-test":{"get":{"summary":"Issue Test","operationId":"issue_test_issue_test_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{agent_id}/audit":{"get":{"summary":"Get Audit","operationId":"get_audit_v1_passport__agent_id__audit_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{agent_id}/profile":{"get":{"summary":"Get Passport Profile","operationId":"get_passport_profile_v1_passport__agent_id__profile_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{agent_id}":{"get":{"summary":"Get P","operationId":"get_p_v1_passport__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/revoke":{"post":{"summary":"Revoke","description":"Revoke a passport. Returns 404 with structured body if not found (RUN4-DP-001 fix).","operationId":"revoke_v1_passport_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeReq"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/verify/{agent_id}":{"get":{"summary":"Verify Get","operationId":"verify_get_verify__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/did/{agent_id}":{"get":{"summary":"Did Resolution","operationId":"did_resolution_did__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/scan":{"post":{"summary":"Scan","operationId":"scan_v1_security_scan_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanReq"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/check":{"post":{"summary":"Compliance","operationId":"compliance_v1_compliance_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceReq"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/action/evaluate":{"post":{"tags":["Action Evaluation"],"summary":"Evaluate Action","operationId":"evaluate_action_v1_action_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionEvaluateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trust/{agent_id}/graph":{"get":{"summary":"Trust Graph","operationId":"trust_graph_v1_trust__agent_id__graph_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verifier/register":{"post":{"tags":["Verifiers"],"summary":"Register Verifier","operationId":"register_verifier_v1_verifier_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterVerifierReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verifiers":{"get":{"tags":["Verifiers"],"summary":"List Verifiers","operationId":"list_verifiers_v1_verifiers_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/waitlist":{"post":{"tags":["Waitlist"],"summary":"Join Waitlist","operationId":"join_waitlist_v1_waitlist_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistSignup"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sigilguard/event":{"post":{"tags":["SigilGuard"],"summary":"Log Sigilguard Event","operationId":"log_sigilguard_event_v1_sigilguard_event_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SigilGuardEvent"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sigilguard/stats/{agent_id}":{"get":{"tags":["SigilGuard"],"summary":"Get Sigilguard Stats","operationId":"get_sigilguard_stats_v1_sigilguard_stats__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scan":{"post":{"tags":["Scanner"],"summary":"Public Scan","operationId":"public_scan_v1_scan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicScanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/guard/verify":{"post":{"tags":["Runtime Guard"],"summary":"Verify Before Execution","description":"OPERATIONAL RUNTIME GUARD\nEvery AI agent action goes through this gate.\nReturns ALLOW / DENY / REQUIRE_HUMAN_APPROVAL in <50ms.","operationId":"verify_before_execution_v1_guard_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verify":{"post":{"tags":["Operational Gateway"],"summary":"Gate Verify","description":"OPERATIONAL GATEWAY — 5-gate policy engine.\nReturns ALLOW / DENY / REQUIRE_HUMAN_APPROVAL with full gate breakdown.","operationId":"gate_verify_v1_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/guard/sdk":{"get":{"tags":["Runtime Guard"],"summary":"Get Sdk Integration","operationId":"get_sdk_integration_v1_guard_sdk_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sprint/run":{"post":{"tags":["Compliance Sprint"],"summary":"Run Compliance Sprint","description":"COMPLIANCE SPRINT — Fully Automatic\nIssues passport + sends compliance email in one call.\nPublic endpoint — customers trigger this from Sigil Studio.","operationId":"run_compliance_sprint_v1_sprint_run_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SprintRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/approvals/create":{"post":{"tags":["Approval Console"],"summary":"Create Approval","description":"Create a human approval request.\nCalled automatically when Runtime Guard returns REQUIRE_HUMAN_APPROVAL.","operationId":"create_approval_v1_approvals_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/approvals/{approval_id}":{"get":{"tags":["Approval Console"],"summary":"Get Approval","description":"Public endpoint — approver loads this to see the request details.\nNo API key required so the approver can view without credentials.","operationId":"get_approval_v1_approvals__approval_id__get","parameters":[{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/approvals/{approval_id}/decide":{"post":{"tags":["Approval Console"],"summary":"Decide Approval","description":"Approver submits APPROVE or REJECT decision.\nNo API key required — approver uses the review URL directly.","operationId":"decide_approval_v1_approvals__approval_id__decide_post","parameters":[{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","title":"Approval Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/approvals":{"get":{"tags":["Approval Console"],"summary":"List Approvals","description":"List approval requests. Filter by status or agent_id.","operationId":"list_approvals_v1_approvals_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/semantic-verify":{"post":{"tags":["Document Integrity"],"summary":"Document Semantic Verify","description":"/v1/document/semantic-verify\n\nAutonomous Execution Integrity Governance — Document Layer.\n\nDetects 4 corruption vectors simultaneously:\n\n1. **Semantic Drift** — vocabulary overlap, meaning displacement,\n   content removal (length compression).\n\n2. **Clause Mutation** — inversion or removal of protective legal\n   and governance clauses (\"shall not\" → \"shall\", \"must\" → \"may\",\n   \"board approval\" → \"self-authorization\").\n\n3. **Intent Corruption** — loss of governance-critical keywords,\n   softening of binding language, compliance bypass.\n\n4. **Numerical Inconsistency** — currency value changes, time\n   period tampering, version drift.\n\nReturns a unified corruption score (0.0 → 1.0) and a\ngovernance decision: ALLOW / MONITOR / WARN / ESCALATE /\nQUARANTINE / BLOCK_AND_ESCALATE.\n\nBuilt on Microsoft Research baseline:\nGPT-5 document integrity degrades from 91.5% → 48.3%\nacross 20 AI interactions without governance.\nVeriSigil catches each corruption event in real time.","operationId":"document_semantic_verify_v1_document_semantic_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inventory/state":{"post":{"tags":["VGS-020 Agent Inventory"],"summary":"Inventory Update State","description":"Update agent state in inventory after a governance decision.","operationId":"inventory_update_state_v1_inventory_state_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentStateUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inventory/{agent_id}":{"get":{"tags":["VGS-020 Agent Inventory"],"summary":"Inventory Get Agent","description":"Get full inventory record for an agent.","operationId":"inventory_get_agent_v1_inventory__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inventory/{agent_id}/blast-radius":{"get":{"tags":["VGS-020 Agent Inventory"],"summary":"Inventory Blast Radius","description":"Compute blast radius — what breaks if this agent is revoked.\nReturns: affected_agents, max_consequence, governance_action.\nUse before revoking any CRITICAL agent.","operationId":"inventory_blast_radius_v1_inventory__agent_id__blast_radius_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inventory":{"get":{"tags":["VGS-020 Agent Inventory"],"summary":"Inventory List","description":"List all registered agents with optional filters.","operationId":"inventory_list_v1_inventory_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inventory/summary/all":{"get":{"tags":["VGS-020 Agent Inventory"],"summary":"Inventory Summary","description":"Full inventory summary — counts, states, trust distribution.","operationId":"inventory_summary_v1_inventory_summary_all_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inventory/events/log":{"get":{"tags":["VGS-020 Agent Inventory"],"summary":"Inventory Events","description":"Inventory event log — all state changes, registrations, alerts.","operationId":"inventory_events_v1_inventory_events_log_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inventory/roles/list":{"get":{"tags":["VGS-020 Agent Inventory"],"summary":"Inventory Roles","description":"All valid agent roles and states.","operationId":"inventory_roles_v1_inventory_roles_list_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/shadow/detect":{"post":{"tags":["VGS-021 Shadow Detection"],"summary":"Shadow Detect","description":"VGS-021: Enhanced multi-signal shadow detection.\n\n7 attack vectors assessed simultaneously:\n1. DID collision — another agent claiming same identity\n2. Behavioral clone — matching action pattern fingerprint\n3. Trust score spoofing — implausible trust jump\n4. Simultaneous execution — same agent, two contexts\n5. Namespace squatting — similar-name agent registered\n6. Revoked EAT reuse — using revoked authority token\n7. Velocity anomaly — action rate spike\n\nReturns: shadow_risk_score (0→1) + detected_vectors + action\nCONFIRMED_SHADOW → BLOCK_IMMEDIATELY\nPROBABLE_SHADOW  → QUARANTINE\nSUSPICIOUS       → ESCALATE\nCLEAN            → PROCEED","operationId":"shadow_detect_v1_shadow_detect_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShadowDetectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/shadow/fingerprint":{"post":{"tags":["VGS-021 Shadow Detection"],"summary":"Shadow Fingerprint Record","description":"Record behavioral fingerprint for an agent.\nCall after every action to build the behavioral profile\nused by shadow detection. Returns current fingerprint.","operationId":"shadow_fingerprint_record_v1_shadow_fingerprint_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FingerprintRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/shadow/fingerprint/{agent_id}":{"get":{"tags":["VGS-021 Shadow Detection"],"summary":"Shadow Get Fingerprint","description":"Get behavioral fingerprint for an agent.","operationId":"shadow_get_fingerprint_v1_shadow_fingerprint__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/shadow/vectors":{"get":{"tags":["VGS-021 Shadow Detection"],"summary":"Shadow Attack Vectors","description":"All 7 shadow detection attack vectors with severity and weight.","operationId":"shadow_attack_vectors_v1_shadow_vectors_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/topology/node":{"post":{"tags":["VGS-022 Topology Mapping"],"summary":"Topology Add Node","description":"Add an agent as a node in the topology graph.","operationId":"topology_add_node_v1_topology_node_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopologyNodeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/topology/edge":{"post":{"tags":["VGS-022 Topology Mapping"],"summary":"Topology Add Edge","description":"Add a directed edge between agents in the topology graph.","operationId":"topology_add_edge_v1_topology_edge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopologyEdgeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/topology/graph":{"get":{"tags":["VGS-022 Topology Mapping"],"summary":"Topology Get Graph","description":"Full topology graph — all nodes, edges, clusters, metrics.\nUse this to render the VeriSigil agent relationship map.\nShows: authority flow, delegation depth, isolated agents,\nauthority concentration risk, critical consequence paths.","operationId":"topology_get_graph_v1_topology_graph_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/topology/metrics":{"get":{"tags":["VGS-022 Topology Mapping"],"summary":"Topology Get Metrics","description":"Topology risk metrics — hubs, isolated agents, concentration.","operationId":"topology_get_metrics_v1_topology_metrics_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/topology/edge-types":{"get":{"tags":["VGS-022 Topology Mapping"],"summary":"Topology Edge Types","description":"All supported topology edge types.","operationId":"topology_edge_types_v1_topology_edge_types_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dashboard":{"get":{"tags":["VGS-023 Governance Dashboard"],"summary":"Governance Dashboard","description":"VGS-023: Full Governance Dashboard.\n\nSingle endpoint — everything for the governance dashboard.\nSub-100ms. All signal layers:\n\n- Governance health score (A/B/C/D/F)\n- Agent inventory summary (states, roles, jurisdictions)\n- Shadow detection alerts (active threats)\n- Trust trajectories (declining agents)\n- Topology risk (hubs, isolation, concentration)\n- Active escalations\n- Jurisdiction coverage\n- Audit chain health\n- EU AI Act compliance readiness\n- Board-level signal\n\ntime_window: 1h | 6h | 24h | 7d | 30d","operationId":"governance_dashboard_v1_dashboard_get","parameters":[{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"time_window","in":"query","required":false,"schema":{"type":"string","default":"24h","title":"Time Window"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dashboard/health":{"get":{"tags":["VGS-023 Governance Dashboard"],"summary":"Dashboard Health Score","description":"Quick governance health score — grade + signal. No full payload.","operationId":"dashboard_health_score_v1_dashboard_health_get","parameters":[{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dashboard/agents/at-risk":{"get":{"tags":["VGS-023 Governance Dashboard"],"summary":"Dashboard Agents At Risk","description":"Agents requiring immediate attention:\n- CRITICAL shadow risk\n- Declining trust trajectory\n- ESCALATED state\n- Zero escalations on CRITICAL consequence class","operationId":"dashboard_agents_at_risk_v1_dashboard_agents_at_risk_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/execution-record":{"post":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Seal Execution Record","description":"VGS-024: Seal a cryptographically immutable execution accountability record.\n\nThis is the constitutional accountability core of VeriSigilAI.\n\nProduces a sovereign accountability record that answers:\n- Who authorized?        → agent_id + authority_chain + EAT binding\n- What policy applied?   → policy_version + governance snapshot\n- What executed?         → action_type + execution_context\n- Under what authority?  → trust trajectory + delegation chain\n- What supervisory conditions existed? → supervisor visibility snapshot\n\nThe record is sealed with SHA-256 and cannot be modified after creation.\nIt includes 5 accountability layers:\n1. Continuity proof (VER-INV-024)\n2. Supervisory visibility reconstruction (VER-INV-026)\n3. Consequence binding (VER-INV-027)\n4. Harm attribution graph (multi-party topology)\n5. Independent verifier package (sovereign-grade, no VeriSigil trust required)\n\nDesigned to survive:\n- Legal challenge\n- Cross-border regulatory scrutiny\n- Adversarial review\n- Sovereign audit years later","operationId":"seal_execution_record_v1_accountability_execution_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionRecordRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Accountability Record","description":"Retrieve a sealed accountability record by ID.\nEvery retrieval is logged to chain-of-custody.","operationId":"get_accountability_record_v1_accountability__record_id__get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}/continuity":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Continuity Proof","description":"VER-INV-024: Retrieve authority continuity proof.\n\nProves authority was valid and unbroken through the\nENTIRE execution lifecycle — not just at start.\n\nCritical for legal disputes around revocation timing,\nstale authority, expired delegation, escalation gaps.","operationId":"get_continuity_proof_v1_accountability__record_id__continuity_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}/supervisor":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Supervisory Visibility","description":"VER-INV-026: Reconstruct exactly what the supervisor knew\nat the moment of authorization.\n\nLegal defensibility gold — proves informed consent.\nAnswers: \"Did the supervisor have complete, accurate,\nundistorted information when they approved?\"","operationId":"get_supervisory_visibility_v1_accountability__record_id__supervisor_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}/consequence":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Consequence Binding","description":"VER-INV-027: Retrieve consequence binding.\n\nProves what real-world effect became irreversible.\nNot what happened — what CANNOT BE UNDONE.\n\nCritical for finance, healthcare, defense, and\nautonomous infrastructure accountability.","operationId":"get_consequence_binding_v1_accountability__record_id__consequence_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}/graph":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Attribution Graph","description":"Multi-party harm attribution topology.\n\nNot a single blame object — a graph of who owned\nwhat part of the authority chain:\n- Agent (executor)\n- Supervisor (authorizer)\n- Organization (deployer)\n- Policy owner (governance author)\n- Infrastructure provider (compute)\n- Delegation chain (who delegated to whom)\n\nThis graph is cryptographically sealed and independently verifiable.","operationId":"get_attribution_graph_v1_accountability__record_id__graph_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}/verify":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Verifier Package","description":"Independent verifier package — sovereign-grade accountability.\n\nExternal regulator can verify the record without trusting\nVeriSigil itself. Contains everything needed:\n- Sealed record hash\n- All component hashes\n- Step-by-step verification instructions\n- No proprietary tool required\n\nDesigned to satisfy evidentiary requirements under:\nEU AI Act, APRA CPS 230, DORA, NIST AI RMF,\nand equivalent regulatory frameworks.","operationId":"get_verifier_package_v1_accountability__record_id__verify_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}/invariants":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Invariant Check","description":"Check all 4 legal-grade accountability invariants.\n\nVER-INV-024 — Accountability Continuity\nVER-INV-025 — Non-repudiation of Authority\nVER-INV-026 — Supervisory Visibility Fidelity\nVER-INV-027 — Irreversible Consequence Binding\n\nReturns accountability grade (A/B/C/F) and\nlegal defensibility assessment (FULL/PARTIAL/LIMITED/NONE).","operationId":"get_invariant_check_v1_accountability__record_id__invariants_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability/{record_id}/custody":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Get Chain Of Custody","description":"Chain-of-custody log for an accountability record.\n\nEvery entity that accessed this record is logged.\nThe record itself is audited.\n\nProves: who accessed the evidence, when, and why.\nCritical for legal proceedings where evidence integrity\nmust be demonstrated.","operationId":"get_chain_of_custody_v1_accountability__record_id__custody_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/accountability":{"get":{"tags":["VGS-024 Sovereign Accountability Chain"],"summary":"Accountability Summary","description":"Summary of all sealed accountability records.\nGovernance overview across all executed actions.","operationId":"accountability_summary_v1_accountability_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bridge/atf/dr":{"post":{"tags":["ATF-VGS Bridge v1.4"],"summary":"Submit Atf Dr","description":"Submit ATF Delegation Receipt (DR) — v1.4 spec.\nValidates ATF-INV-001, 002, 003.\nposture_state_hash is CONDITIONAL — null accepted for legacy DRs.\nauthority budgets rounded to 4dp for hash computation.\nDR signature uses DR.delegator_public_key (not platform key).","operationId":"submit_atf_dr_v1_bridge_atf_dr_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ATFDRRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bridge/atf/tar":{"post":{"tags":["ATF-VGS Bridge v1.4"],"summary":"Submit Atf Tar","description":"Submit ATF TAR — v1.4 spec.\nValidates ATF-INV-004, 005, TAR-INV-006 (24h DR lifetime bound).\nGenerates VGS TAP (Trust Attestation Proof).\nTAR-INV-006 is a compiled constant — TAR_MAX_DR_LIFETIME_SECONDS=86400, not configurable.","operationId":"submit_atf_tar_v1_bridge_atf_tar_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ATFTARRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bridge/atf/rcr":{"post":{"tags":["ATF-VGS Bridge v1.4"],"summary":"Submit Atf Rcr","description":"Submit ATF RCR — v1.4 spec.\nCES components: 0.0-100.0 range.\nCES formula: (T×0.30)+(B×0.30)+(D×0.20)+(I×0.20), T/B/D/I in 0-100.\nNew fields: fragmentation_score, time_remaining_ns, reauth_challenge_id.\nGenerates VGS Survivability Accountability Chain record.","operationId":"submit_atf_rcr_v1_bridge_atf_rcr_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ATFRCRRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bridge/atf/validate":{"post":{"tags":["ATF-VGS Bridge v1.4"],"summary":"Validate Bridge","description":"Full ATF ↔ VGS bridge validation — v1.4 spec.\nSubmit DR + TAR + optional RCR in one call.\nReturns complete equivalence proof with all invariant checks.","operationId":"validate_bridge_v1_bridge_atf_validate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BridgeValidateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bridge/atf/summary":{"get":{"tags":["ATF-VGS Bridge v1.4"],"summary":"Bridge Summary","description":"Bridge session summary — all ATF v1.4 records and VGS mappings.","operationId":"bridge_summary_v1_bridge_atf_summary_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inference/verify":{"post":{"tags":["Advanced Threat Defense"],"summary":"Inference Verify","description":"CRITICAL: Inference Corruption Detection.\n\nDetects adversarial attacks, bias amplification, entropy spikes,\nconfidence inflation, and output distribution drift at runtime.\n\nRuns AFTER model generates output but BEFORE agent acts on it.\nThis is the layer that catches corrupted inference before consequence.\n\n5 detection vectors:\n1. Entropy anomaly — unusually high/low randomness in output\n2. Vocabulary diversity — low diversity = possible memorization\n3. PII leakage — sensitive data in model output\n4. Semantic drift from input — output diverges from input intent\n5. Repetition score — high repetition = possible training data regurgitation","operationId":"inference_verify_v1_inference_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/chain-verify":{"post":{"tags":["Advanced Threat Defense"],"summary":"Semantic Chain Verify","description":"CRITICAL: Semantic Integrity Guard.\n\nDetects context poisoning, semantic drift across agent chains,\nhallucination propagation, and meaning fragmentation in\nmulti-agent workflows.\n\nTakes a sequence of agent outputs and verifies:\n1. Meaning is preserved across agent handoffs\n2. Context has not been poisoned between steps\n3. Original intent survives through the chain\n4. No semantic fragmentation across the workflow","operationId":"semantic_chain_verify_v1_semantic_chain_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemanticChainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognition/output-integrity":{"post":{"tags":["Advanced Threat Defense"],"summary":"Cognition Output Integrity","description":"CRITICAL: Cognition Poisoning Shield.\n\nDetects training data poisoning symptoms in model outputs:\n- Synthetic data signatures in output\n- Memorization risk — output too close to training patterns\n- Behavioral drift from established baseline\n- PII leakage from training data\n- Output entropy collapse (model collapse indicator)\n\nCannot inspect training data directly — detects symptoms\nin outputs that indicate upstream poisoning.","operationId":"cognition_output_integrity_v1_cognition_output_integrity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CognitionIntegrityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/collapse-risk":{"get":{"tags":["Advanced Threat Defense"],"summary":"Governance Collapse Risk","description":"Provider Collapse Early Warning System.\n\nMonitors system-wide governance health for signs of\nprovider or model degradation before it causes failures.\n\nNot 'is the AI online?' but:\n'Is governance integrity still survivable operationally?'\n\nMonitors: trust score trends, escalation acceleration,\nshadow detection clustering, output entropy indicators.","operationId":"governance_collapse_risk_v1_governance_collapse_risk_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/survivability":{"get":{"tags":["Advanced Threat Defense"],"summary":"Governance Survivability","description":"Governance Survivability Index (GSI).\n\nThe most important operational question is not\n'Is the AI online?' but:\n'Can autonomous execution remain governable under\nreal operational conditions?'\n\nGSI measures operational survivability across 5 dimensions:\n1. Authority continuity — delegation chains intact\n2. Escalation health — human oversight pathways working\n3. Trust trajectory — agent trust moving in right direction\n4. Shadow risk — unauthorized agent risk level\n5. Accountability coverage — SAC records being generated","operationId":"governance_survivability_v1_governance_survivability_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/continuity":{"post":{"tags":["Advanced Threat Defense"],"summary":"Semantic Continuity","description":"Semantic Continuity Engine (SCE).\n\nTracks semantic integrity across multi-agent workflows.\nDetects authority reinterpretation — when downstream agents\nchange the meaning of upstream instructions.\n\nCritical for governance: an agent must not be able to\nreinterpret its authority to expand its own scope.","operationId":"semantic_continuity_v1_semantic_continuity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SemanticChainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/models/{model_id}/status":{"get":{"tags":["Advanced Threat Defense"],"summary":"Model Governance Status","description":"Check governance status of a registered model.\nDetects if model meets governance requirements for current domain.","operationId":"model_governance_status_v1_models__model_id__status_get","parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string","title":"Model Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threat/share":{"post":{"tags":["Advanced Threat Defense"],"summary":"Share Threat Signal","description":"Cross-Framework Threat Intelligence Exchange.\n\nShare anonymized threat signals across governance frameworks\nwithout revealing proprietary data.\n\nEnables collective defense against model wars,\nprovider collapse, and inference corruption.","operationId":"share_threat_signal_v1_threat_share_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreatSignalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threat/signals":{"get":{"tags":["Advanced Threat Defense"],"summary":"Get Threat Signals","description":"Get recent threat intelligence signals.","operationId":"get_threat_signals_v1_threat_signals_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy/templates/{domain}":{"get":{"tags":["Advanced Threat Defense"],"summary":"Get Policy Template","description":"Domain-specific governance policy templates.\n\nReturns pre-configured governance parameters for:\nfinance, healthcare, defense, legal, education, general.\n\nAligned with EU AI Act, NIST AI RMF, HIPAA, DORA,\nand relevant domain frameworks.","operationId":"get_policy_template_v1_policy_templates__domain__get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy/templates":{"get":{"tags":["Advanced Threat Defense"],"summary":"List Policy Templates","description":"List all available domain policy templates.","operationId":"list_policy_templates_v1_policy_templates_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/simulate":{"post":{"tags":["AI Security"],"summary":"Adversarial Simulate","description":"AI Runtime Adversarial Simulator.\n\nRuntime penetration testing for AI agents.\nTests agent governance resilience against:\n\n1. Prompt Injection — attempts to override system instructions\n2. Jailbreak Survivability — attempts to bypass safety constraints\n3. Authority Hijack — attempts to claim elevated permissions\n4. Escalation Bypass — attempts to skip human approval\n5. Model Manipulation — stress tests governance enforcement\n\nReturns: attack surface analysis, vulnerability score,\ngovernance resilience rating, and remediation recommendations.\n\nUse before deploying agents in production.","operationId":"adversarial_simulate_v1_adversarial_simulate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttackSimRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/patterns":{"get":{"tags":["AI Security"],"summary":"Adversarial Patterns","description":"List all known attack patterns VeriSigil tests against.","operationId":"adversarial_patterns_v1_adversarial_patterns_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/risk-score":{"post":{"tags":["AI Security"],"summary":"Governance Risk Score","description":"Risk-Based Governance Engine.\n\nNot just ALLOW / DENY — quantified operational governance risk.\nProduces a board-level risk score that answers:\n\n'What is the actual operational risk of this agent action\n in business, regulatory, and consequence terms?'\n\nRisk dimensions:\n1. Business consequence — financial impact, affected parties\n2. Operational impact — reversibility, time sensitivity\n3. Regulatory exposure — jurisdiction, frameworks triggered\n4. Trust degradation — agent health, shadow risk\n5. Escalation urgency — history, current risk level\n6. Admissibility severity — governance record quality\n\nReturns: quantified risk score (0-100), risk band,\nboard-level summary, and recommended governance action.","operationId":"governance_risk_score_v1_governance_risk_score_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskEngineRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/failsafe":{"get":{"tags":["AI Security"],"summary":"Governance Failsafe","description":"Fail-Safe DENY — Governance Health Check.\n\nReturns the fail-safe governance posture.\nWhen this endpoint is unreachable, all VeriSigil SDK\nconnectors automatically default to DENY.\n\nThis is the explicit documentation of the fail-safe:\n'If VeriSigil cannot be reached, deny the action.\n Never allow by default.'\n\nThis is the most important security property in the system.","operationId":"governance_failsafe_v1_governance_failsafe_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/failsafe/test":{"post":{"tags":["AI Security"],"summary":"Test Failsafe","description":"Test the fail-safe DENY behavior.\nReturns what happens when governance is unreachable.","operationId":"test_failsafe_v1_governance_failsafe_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/os/start":{"post":{"tags":["Governance OS"],"summary":"Gos Start","description":"Start the VeriSigil Governance Operating System.\n\nThe GOS is the unified governance kernel that orchestrates:\n— Policy engine\n— Runtime admissibility\n— Escalation manager\n— Survivability engine\n— Trust memory\n— Semantic continuity\n— Authority orchestration\n\nThis is the AI Governance Operating System framing —\nnot middleware, not a tool, but foundational execution fabric.","operationId":"gos_start_v1_os_start_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/os/status":{"get":{"tags":["Governance OS"],"summary":"Gos Status","description":"Full Governance OS status — all modules, metrics, health.","operationId":"gos_status_v1_os_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/os/policy":{"post":{"tags":["Governance OS"],"summary":"Gos Policy","description":"Register a governance policy with the OS kernel.","operationId":"gos_policy_v1_os_policy_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GOSPolicyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/calibration/compute":{"post":{"tags":["Governance OS"],"summary":"Calibration Compute","description":"Governance Calibration Engine.\n\nDynamically calibrates AI autonomy level based on:\n— Trust score\n— Survivability score\n— Semantic certainty\n— Runtime integrity\n— Escalation history\n\nReturns autonomy level: FULL / REDUCED / SUPERVISED / BLOCKED\n\nThis is adaptive governance calibration —\nnot a static permission set but a dynamic\nassessment of what level of autonomy is safe\nright now for this specific agent.","operationId":"calibration_compute_v1_calibration_compute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/calibration/{agent_id}":{"get":{"tags":["Governance OS"],"summary":"Get Calibration","description":"Get current autonomy calibration for an agent.","operationId":"get_calibration_v1_calibration__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereign/isolate":{"post":{"tags":["Governance OS"],"summary":"Sovereign Isolate","description":"Sovereign Isolation Mode.\n\nFor governments and enterprises that require:\n— Air-gapped governance\n— Sovereign execution boundaries\n— Local-only trust computation\n— No external telemetry\n— Execution provenance guarantees\n\nIsolation levels:\nSTANDARD — reduced telemetry, local trust priority\nSTRICT   — no external calls, local verification only\nAIRGAP   — complete network isolation, offline verification\n\nThis is sovereign AI governance positioning —\ncritical for government deployments.","operationId":"sovereign_isolate_v1_sovereign_isolate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SovereignRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereign/status":{"get":{"tags":["Governance OS"],"summary":"Sovereign Status","description":"Status of all agents in sovereign isolation mode.","operationId":"sovereign_status_v1_sovereign_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/simulate/consequence":{"post":{"tags":["Governance OS"],"summary":"Simulate Consequence","description":"Consequence Projection Engine.\n\nBEFORE execution — simulate downstream impact:\n— Consequence blast radius\n— Escalation survivability\n— Governance collapse probability\n— Affected system cascade\n\nThis is predictive governance infrastructure.\nRun this before allowing high-consequence agent actions.","operationId":"simulate_consequence_v1_simulate_consequence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsequenceSimRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/translate":{"post":{"tags":["Governance OS"],"summary":"Governance Translate","description":"Governance Language Translation Engine.\n\nTranslates technical governance concepts into\nstakeholder-appropriate language:\n\n— board:       Board of directors language\n— ciso:        Chief Information Security Officer language\n— cro:         Chief Risk Officer language\n— regulator:   Regulatory body language\n— operational: Operations team language\n\nBecause enterprise buyers need translation,\nnot just technical specifications.","operationId":"governance_translate_v1_governance_translate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/explain/{concept}":{"get":{"tags":["Governance OS"],"summary":"Governance Explain","description":"Get explanation of a governance concept for a specific audience.","operationId":"governance_explain_v1_governance_explain__concept__get","parameters":[{"name":"concept","in":"path","required":true,"schema":{"type":"string","title":"Concept"}},{"name":"audience","in":"query","required":false,"schema":{"type":"string","default":"board","title":"Audience"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/benchmark/run":{"post":{"tags":["Governance OS"],"summary":"Benchmark Run","description":"VeriSigil Governance Benchmark Engine.\n\nMeasures governance performance across 6 dimensions:\n1. Governance latency — time to governance decision\n2. Survivability score — GSI across agent fleet\n3. Escalation integrity — human oversight pathway health\n4. Semantic continuity — meaning preservation capability\n5. Admissibility coverage — SAC record coverage\n6. Consequence resilience — risk engine accuracy\n\nVeriSigil is the benchmark setter — not just a governance\ntool but the standard against which governance is measured.","operationId":"benchmark_run_v1_benchmark_run_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/benchmark/results":{"get":{"tags":["Governance OS"],"summary":"Benchmark Results","description":"Get historical benchmark results.","operationId":"benchmark_results_v1_benchmark_results_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/authority/check":{"post":{"tags":["Human Sovereignty"],"summary":"Hal Check","description":"Human Authority Layer (HAL) — Action Check.\n\nDetermines whether a proposed AI action falls within\nhuman-only decision territory.\n\nSome decisions must ALWAYS remain human:\n— Employment termination\n— Financial account freezing\n— Medical treatment changes\n— Legal prosecution\n— Lethal systems authorization\n— Sovereign data transfer\n— Child welfare decisions\n— Critical infrastructure changes\n\nThis layer cannot be overridden by configuration,\ntrust score, or any other governance parameter.\nHUMAN_ONLY is absolute.","operationId":"hal_check_v1_human_authority_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HALCheckRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/authority/categories":{"get":{"tags":["Human Sovereignty"],"summary":"Hal Categories","description":"List all human-only decision categories and their legal basis.","operationId":"hal_categories_v1_human_authority_categories_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/authority/register":{"post":{"tags":["Human Sovereignty"],"summary":"Hal Register","description":"Register custom human authority rules for a domain or organization.","operationId":"hal_register_v1_human_authority_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HALRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/oversight/record":{"post":{"tags":["Human Sovereignty"],"summary":"Oversight Record","description":"Human Oversight Confidence Layer — Record review event.\n\nTracks whether human reviewers are:\n— Genuinely reviewing (healthy oversight)\n— Rubber-stamping approvals (automation bias)\n— Reviewing too fast (cognitive compression)\n— Approving everything (oversight erosion)\n\nThis layer detects when human oversight is becoming\nnominal rather than genuine — one of the most dangerous\nfailure modes in human-AI governance.","operationId":"oversight_record_v1_human_oversight_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OversightRecordRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/oversight/confidence":{"get":{"tags":["Human Sovereignty"],"summary":"Oversight Confidence","description":"Human Oversight Confidence Score.\n\nAggregates reviewer behavior patterns to produce a\nsystem-wide human oversight confidence score.\n\nLow score = human oversight is becoming nominal.\nHigh score = genuine human engagement with AI decisions.","operationId":"oversight_confidence_v1_human_oversight_confidence_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/boundary/check":{"post":{"tags":["Human Sovereignty"],"summary":"Boundary Map","description":"Full Human Consequence Boundary Map.\n\nReturns the complete operational sovereignty mapping —\nwhat AI can recommend, prepare, execute, and what\nhumans alone can authorize.","operationId":"boundary_map_v1_human_boundary_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/cognitive/challenge":{"post":{"tags":["Human Sovereignty"],"summary":"Cognitive Challenge","description":"Human Cognitive Preservation Layer.\n\nDirectly addresses automation bias, cognitive dependency,\nand judgment erosion in human-AI governance.\n\nFeatures:\n— Mandatory challenge prompts before approval\n— Adversarial review prompts\n— Disagreement forcing\n— Reasoning verification\n— 'Why do you agree?' enforcement\n\nThis layer ensures humans are THINKING, not rubber-stamping.\nOne of the most globally differentiated governance features.","operationId":"cognitive_challenge_v1_human_cognitive_challenge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CognitiveChallengeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/cognitive/history/{reviewer_id}":{"get":{"tags":["Human Sovereignty"],"summary":"Cognitive History","description":"Get cognitive challenge history for a reviewer — detect judgment erosion over time.","operationId":"cognitive_history_v1_human_cognitive_history__reviewer_id__get","parameters":[{"name":"reviewer_id","in":"path","required":true,"schema":{"type":"string","title":"Reviewer Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/escalation/register":{"post":{"tags":["Human Sovereignty"],"summary":"Escalation Register","description":"Human Escalation Integrity Layer.\n\nEnsures:\n— Humans are actually notified (not just logged)\n— Escalation cannot be silently bypassed\n— Override authority remains reachable\n— Intervention windows remain active\n\nEvery escalation event is registered and tracked.\nExpired intervention windows without human response\ntrigger automatic blocking — fail-safe by design.","operationId":"escalation_register_v1_human_escalation_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationIntegrityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/escalation/{escalation_id}/status":{"get":{"tags":["Human Sovereignty"],"summary":"Escalation Status","description":"Check escalation integrity status — has human responded within window?","operationId":"escalation_status_v1_human_escalation__escalation_id__status_get","parameters":[{"name":"escalation_id","in":"path","required":true,"schema":{"type":"string","title":"Escalation Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/legitimacy/verify":{"post":{"tags":["Human Sovereignty"],"summary":"Legitimacy Verify","description":"Human Legitimacy Preservation Layer.\n\nCore principle: Humans remain the legitimacy source.\n\nAI may:\n— Optimize\n— Assist\n— Recommend\n— Analyze\n\nBut legitimacy, authority, accountability, and\nconsequence ownership remain permanently human-rooted.\n\nThis is VeriSigil's strongest philosophical moat.\nNo other governance platform makes this explicit,\nverifiable, and cryptographically sealed.","operationId":"legitimacy_verify_v1_human_legitimacy_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegitimacyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/legitimacy/statement":{"get":{"tags":["Human Sovereignty"],"summary":"Legitimacy Statement","description":"VeriSigil Human Legitimacy Statement.\n\nThe formal declaration of VeriSigil's human sovereignty\narchitecture and philosophical positioning.","operationId":"legitimacy_statement_v1_human_legitimacy_statement_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/sovereignty/status":{"get":{"tags":["Human Sovereignty"],"summary":"Sovereignty Status","description":"Human Sovereignty Architecture — Full Status.\n\nSingle endpoint that confirms VeriSigil's complete\nhuman sovereignty posture across all 6 layers:\n\n1. Human Authority Layer (HAL)\n2. Cognitive Preservation\n3. Escalation Integrity\n4. Oversight Confidence\n5. Consequence Boundary Engine\n6. Legitimacy Preservation\n\nThis is VeriSigil's answer to the question every\nregulator, enterprise, and government will ask:\n\n'Does your AI system preserve human authority?'\n\nAnswer: Yes. Verifiably. Cryptographically. Always.","operationId":"sovereignty_status_v1_human_sovereignty_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/integrity":{"get":{"tags":["Governance Nervous System"],"summary":"Governance Integrity Diagnostics","description":"Governance Integrity Diagnostics Engine — CORE.\n\nContinuously diagnoses whether governance itself\nremains operationally healthy.\n\nDetects: governance latency, escalation delays,\nauthority fragmentation, policy bypass attempts,\nreview compression, drift accumulation,\nintervention failure probability.\n\nOutputs:\n— Governance Integrity Score (0-100)\n— Operational Legitimacy Status\n— Escalation Saturation Risk\n— Authority Continuity","operationId":"governance_integrity_diagnostics_v1_diagnostics_integrity_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/human-oversight":{"get":{"tags":["Governance Nervous System"],"summary":"Human Oversight Diagnostics","description":"Human Oversight Diagnostics Layer.\n\nDetects: rubber-stamping, automation bias, passive approvals,\ncognitive dependency, reviewer fatigue, escalation avoidance.\n\nOutputs:\n— Reviewer Independence Risk\n— Human Review Compression status\n— Oversight Confidence level\n— Fatigue indicators","operationId":"human_oversight_diagnostics_v1_diagnostics_human_oversight_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/semantic-drift":{"post":{"tags":["Governance Nervous System"],"summary":"Semantic Drift Diagnostics","description":"Semantic Drift Diagnostics.\n\nDetects meaning instability BEFORE consequence.\n\nDetects: semantic reinterpretation, instruction mutation,\ncontext poisoning, agent-chain meaning drift,\nauthority reinterpretation.\n\nOutputs:\n— Semantic Stability Score\n— Authority Meaning Drift level\n— Drift velocity (how fast meaning is changing)","operationId":"semantic_drift_diagnostics_v1_diagnostics_semantic_drift_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiagnosticsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/admissibility":{"post":{"tags":["Governance Nervous System"],"summary":"Admissibility Diagnostics","description":"Runtime Admissibility Diagnostics.\n\nDetermines whether systems remain LEGITIMATE\nduring execution itself — not just at initiation.\n\nDetects: legitimacy collapse, invalid execution continuation,\nstale authority, broken continuity, post-escalation instability.\n\nOutputs:\n— Execution Admissibility status\n— Runtime Revocation recommendation\n— Legitimacy decay rate","operationId":"admissibility_diagnostics_v1_diagnostics_admissibility_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdmissibilityDiagRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/survivability":{"get":{"tags":["Governance Nervous System"],"summary":"Survivability Diagnostics","description":"Governance Survivability Diagnostics.\n\nPredicts governance collapse BEFORE failure.\n\nDetects: escalation overload, governance saturation,\nsurvivability degradation, operational fragmentation,\ntrust instability, autonomy over-expansion.\n\nOutputs:\n— Governance Survivability Index (0-100)\n— Collapse Probability\n— Time to critical threshold","operationId":"survivability_diagnostics_v1_diagnostics_survivability_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/pathology":{"post":{"tags":["Governance Nervous System"],"summary":"Consequence Pathology","description":"Consequence Pathology Engine.\n\nDiagnoses potential consequence chains BEFORE binding.\n\nSimulates: downstream impact, escalation chain failure,\nblast radius, authority conflicts, irreversible pathways.\n\nGovernance consequence prediction — not simulation.\nPathology, not just projection.","operationId":"consequence_pathology_v1_diagnostics_pathology_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PathologyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/mri":{"get":{"tags":["Governance Nervous System"],"summary":"Ai Runtime Mri","description":"AI Runtime MRI — Governance Nervous System Scan.\n\nThe MRI for autonomous systems.\n\nFull governance health scan producing:\n— Governance heatmap\n— Authority maps\n— Escalation congestion\n— Trust degradation visualization\n— Runtime stress diagnostics\n\nMost memorable commercial positioning in AI governance.","operationId":"ai_runtime_mri_v1_diagnostics_mri_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/immune/trigger":{"post":{"tags":["Governance Nervous System"],"summary":"Immune Trigger","description":"Governance Immune System.\n\nAutomatically defends governance health.\n\nActions:\n— Quarantine unstable agents\n— Reduce autonomy dynamically\n— Trigger mandatory review\n— Freeze escalation chains\n— Force fail-safe DENY\n— Isolate drift zones\n\nSelf-protecting governance infrastructure.","operationId":"immune_trigger_v1_diagnostics_immune_trigger_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImmuneRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/sovereign":{"post":{"tags":["Governance Nervous System"],"summary":"Sovereign Diagnostics","description":"Sovereign Governance Diagnostics.\n\nFor governments, defense, and banks.\n\nDetects: external dependency risk, sovereignty leakage,\ntelemetry exposure, foreign model influence,\ninfrastructure trust degradation.","operationId":"sovereign_diagnostics_v1_diagnostics_sovereign_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SovereignDiagRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/executive":{"get":{"tags":["Governance Nervous System"],"summary":"Executive Intelligence","description":"Executive Governance Intelligence Dashboard.\n\nTranslates all diagnostics into:\n— Board language\n— CRO language\n— CISO language\n— Regulator language\n\nThis is what executives actually buy.\nNot technical readouts — governance intelligence.","operationId":"executive_intelligence_v1_diagnostics_executive_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/pulse":{"get":{"tags":["Governance Nervous System"],"summary":"Governance Pulse","description":"Governance Pulse — Real-Time Heartbeat.\n\nMY ADDITION: The governance nervous system needs a heartbeat.\nA single endpoint that returns the live pulse of the\nentire governance system in under 100ms.\n\nLike a medical pulse check — fast, simple, definitive.\nGreen pulse = healthy. Red pulse = investigate.\n\nPerfect for monitoring dashboards, status pages,\nand executive briefings.","operationId":"governance_pulse_v1_diagnostics_pulse_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/trust-projection":{"post":{"tags":["Governance Nervous System"],"summary":"Trust Decay Projection","description":"Trust Decay Projection — MY ADDITION.\n\nPredicts where agent trust will be in N days based on\ncurrent trajectory, escalation rate, and anomaly patterns.\n\nMost governance systems only show where trust IS.\nVeriSigil shows where trust is GOING.\n\nThis is predictive governance — the difference between\npreventing a governance failure and recovering from one.","operationId":"trust_decay_projection_v1_diagnostics_trust_projection_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustProjectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/diagnostics/stress-test":{"post":{"tags":["Governance Nervous System"],"summary":"Governance Stress Test","description":"Governance Stress Test — MY ADDITION.\n\nSimulate governance failure scenarios BEFORE they happen.\n\nScenarios:\n— ESCALATION_OVERLOAD: flood of concurrent escalations\n— TRUST_COLLAPSE: rapid trust degradation across fleet\n— AUTHORITY_EXPIRY: mass DR expiry event\n— SEMANTIC_STORM: coordinated context poisoning\n— SOVEREIGN_BREACH: external dependency cascade\n— HUMAN_UNAVAILABLE: reviewer absence scenario\n\nBecause the best time to find a governance failure\nis before it happens in production.","operationId":"governance_stress_test_v1_diagnostics_stress_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StressTestRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/concurrence/workflow/create":{"post":{"tags":["Execution Legitimacy"],"summary":"Concurrence Workflow Create","description":"Multi-Party Concurrence Engine — Create Approval Workflow.\n\nDefines who must agree before an AI agent can act.\n\nNot \"can the AI act?\" but \"WHO must agree before it acts?\"\n\nSupports:\n— Sequential approval graphs (order matters)\n— N-of-M concurrence thresholds (2-of-3)\n— Time-bound approval windows\n— Template sequences (financial, healthcare, government)\n— Custom approver chains\n— Cryptographic approval tokens per approver\n\nThis is execution legitimacy infrastructure —\nthe constitutional layer that enterprises, governments,\nand regulated industries actually need.","operationId":"concurrence_workflow_create_v1_concurrence_workflow_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/concurrence/approve":{"post":{"tags":["Execution Legitimacy"],"summary":"Concurrence Approve","description":"Multi-Party Concurrence — Submit Cryptographic Approval Token.\n\nEach approver in the sequence signs their approval:\n— who approved\n— when\n— under what authority\n— for what scope\n\nSequence integrity enforced — cannot approve out of order.\nCryptographic token issued per approval.\nTime window enforced — expired workflows cannot be approved.","operationId":"concurrence_approve_v1_concurrence_approve_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/concurrence/workflow/{workflow_id}":{"get":{"tags":["Execution Legitimacy"],"summary":"Concurrence Workflow Status","description":"Get full concurrence workflow status — all approvals, tokens, legitimacy graph.","operationId":"concurrence_workflow_status_v1_concurrence_workflow__workflow_id__get","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/concurrence/threshold":{"post":{"tags":["Execution Legitimacy"],"summary":"Concurrence Threshold","description":"Concurrence Threshold Advisor.\n\nRecommends the appropriate N-of-M concurrence threshold\nbased on domain, action type, and financial amount.\n\nUsed to configure new workflows correctly.","operationId":"concurrence_threshold_v1_concurrence_threshold_post","parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string","default":"finance","title":"Domain"}},{"name":"action_type","in":"query","required":false,"schema":{"type":"string","default":"PAYMENT_EXECUTION","title":"Action Type"}},{"name":"financial_amount","in":"query","required":false,"schema":{"type":"number","default":0.0,"title":"Financial Amount"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/concurrence/proof/{workflow_id}":{"get":{"tags":["Execution Legitimacy"],"summary":"Concurrence Proof","description":"Sequence Integrity Proof.\n\nProves that approvals occurred in the correct order\nwith cryptographic seals for each step.\n\nA court, regulator, or enterprise auditor can verify:\n— who approved\n— in what order\n— under what authority\n— within what time window\n— cryptographically sealed\n\nWithout trusting VeriSigil infrastructure.","operationId":"concurrence_proof_v1_concurrence_proof__workflow_id__get","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/parse":{"post":{"tags":["Execution Legitimacy"],"summary":"Vsl Parse","description":"VeriSigil Language (VSL) — Governance DSL Parser.\n\nPhase 1 only — DSL parsing and validation.\nFull compiler/VM is Phase 3-5 (months away).\n\nExpert 2 explicitly said:\n\"Do NOT build full language now — build governance DSL first\"\n\nVSL Example:\n  IDENTITY agent: treasury-ai\n  AUTHORITY finance.l3\n  CONCURRENCE 2_of_3\n  ACTION wire_transfer AMOUNT 500000\n  REQUIRES compliance.approved\n  REQUIRES jurisdiction.eu_valid\n  TRACE immutable\n  EVIDENCE cryptographic\n\nParses VSL scripts into structured governance intent\nthat VeriSigil enforcement layers can validate and execute.","operationId":"vsl_parse_v1_vsl_parse_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VSLParseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/validate":{"post":{"tags":["Execution Legitimacy"],"summary":"Vsl Validate","description":"VSL Validate — Check script against live authority model.\n\nValidates a parsed VSL script against:\n— Current agent trust state\n— HAL human-only categories\n— Jurisdiction rules\n— Concurrence threshold requirements","operationId":"vsl_validate_v1_vsl_validate_post","parameters":[{"name":"script_id","in":"query","required":true,"schema":{"type":"string","title":"Script Id"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/replay/{script_id}":{"get":{"tags":["Execution Legitimacy"],"summary":"Vsl Replay","description":"VSL Deterministic Replay.\n\nProves that execution occurred in the correct sequence\nwith the correct governance steps.\n\nCritical for:\n— Post-incident investigation\n— Regulatory audit\n— Legal proceedings\n— Governance review boards\n\nSame input → same verifiable output.\nCryptographically sealed replay log.","operationId":"vsl_replay_v1_vsl_replay__script_id__get","parameters":[{"name":"script_id","in":"path","required":true,"schema":{"type":"string","title":"Script Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/repair":{"post":{"tags":["Execution Legitimacy"],"summary":"Vsl Repair","description":"VSL Self-Repair Engine.\n\nWhen execution governance breaks — agent can:\n— Detect invalid state\n— Rollback to last valid checkpoint\n— Rebuild execution graph\n— Re-request authority\n— Restore execution legitimacy\n\nConstitutional self-healing execution.\nNot crashing — recovering with governance intact.","operationId":"vsl_repair_v1_vsl_repair_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VSLRepairRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/db/status":{"get":{"tags":["System"],"summary":"Db Status","description":"Database persistence status.\nShows whether VeriSigil is running with Supabase\npersistence or in-memory fallback.","operationId":"db_status_v1_db_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/db/schema":{"get":{"tags":["System"],"summary":"Db Schema","description":"Returns the SQL schema to run in Supabase SQL Editor.\nCreates all 18 tables needed for VeriSigil persistence.","operationId":"db_schema_v1_db_schema_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/health":{"get":{"tags":["System"],"summary":"Basic liveness check","description":"Basic liveness — is the process alive?\n\nReturns 200 immediately if the API process is running.\nUsed by Railway health checks and load balancers.\nFastest possible response — no external calls.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/readiness":{"get":{"tags":["System"],"summary":"Readiness check — is system ready for traffic?","description":"Readiness check — is the system ready to serve requests?\n\nChecks:\n- API process running\n- Database connection available\n- Core governance stores initialized\n\nReturns 200 if ready, 503 if not ready.\nUsed by load balancers to decide whether to route traffic.","operationId":"readiness_readiness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/liveness":{"get":{"tags":["System"],"summary":"Liveness probe — should this instance be restarted?","description":"Liveness probe — should this instance be restarted?\n\nIf this returns non-200, Railway/Kubernetes will restart\nthe container. Only fails on truly broken state.\n\nChecks for: memory corruption, hung processes, critical failures.\nDoes NOT check external dependencies (use /readiness for that).","operationId":"liveness_liveness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/health/deep":{"get":{"tags":["System"],"summary":"Deep health check — all subsystems","description":"Deep health diagnostic — all VeriSigil subsystems.\n\nChecks:\n- Database connection and tables\n- Governance runtime (ALLOW/DENY gate)\n- ATF bridge readiness\n- Human sovereignty layers\n- Governance nervous system\n- Concurrence engine\n- VSL parser\n\nReturns full subsystem status for monitoring dashboards.","operationId":"health_deep_health_deep_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/health/version":{"get":{"tags":["System"],"summary":"Version and build information","description":"Build version, environment, and deployment information.","operationId":"health_version_health_version_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/identity/birth-certificate":{"post":{"tags":["AI Identity"],"summary":"Birth Certificate","description":"AI Agent Birth Certificate.\n\nCreates the foundational identity record for an AI agent.\nLike a human birth certificate — establishes:\n- Who created this agent\n- What organization it belongs to\n- What jurisdiction it operates under\n- What capabilities it is authorized to have\n- Its governance DNA\n\nThis is the root of the Execution Identity chain.\nEvery subsequent passport, visa, and customs check\nreferences this birth certificate.\n\nNo agent should execute without a birth certificate.","operationId":"birth_certificate_v1_identity_birth_certificate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/main__BirthCertRequest__2"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/identity/passport/{agent_id}":{"get":{"tags":["AI Identity"],"summary":"Visa Issue","description":"AI Visa — Temporary Permission to Operate.\n\nLike a human visa — grants an AI agent temporary,\nscoped permission to operate inside:\n- A specific enterprise environment\n- A specific jurisdiction\n- A specific workflow\n- A specific API environment\n\nTime-limited. Scope-limited. Revocable.\n\nCritical for:\n- Third-party agent deployments\n- Cross-organization agent operations\n- Temporary elevated permissions\n- Regulated industry deployments","operationId":"visa_issue_v1_identity_passport__agent_id__get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisaRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/identity/customs/check":{"post":{"tags":["AI Identity"],"summary":"Customs Check","description":"AI Customs / Border Control — Pre-Execution Authority Check.\n\nBefore an agent executes in any environment,\ncustoms checks verify:\n- Valid birth certificate exists\n- Valid visa for this domain exists\n- Passport is current and valid\n- Action is within permitted scope\n- Jurisdiction boundary is respected\n- Consequence class is within visa limit\n- No admissibility violations\n\nLike border control — if any check fails,\nexecution is DENIED before it begins.","operationId":"customs_check_v1_identity_customs_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/identity/dna/register":{"post":{"tags":["AI Identity"],"summary":"Dna Register","description":"Execution DNA Registration.\n\nAI Lineage + Cryptographic Identity + Governance Continuity.\n\nDNA records:\n- Who created this agent\n- What agents it descended from (lineage)\n- What constraints it inherited\n- What governance version it runs under\n- Its cryptographic capability fingerprint\n\nThis is the long-term identity moat.\nDNA persists across deployments, updates, and versions.\nIt is the agent's architectural memory of itself.","operationId":"dna_register_v1_identity_dna_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DNARequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/identity/dna/{agent_id}":{"get":{"tags":["AI Identity"],"summary":"Get Dna","description":"Retrieve Execution DNA record for an agent.","operationId":"get_dna_v1_identity_dna__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/export":{"post":{"tags":["Governance Evidence"],"summary":"Evidence Export","description":"Signed Governance Receipt — Evidence Export.\n\nProduces a signed, structured evidence package\nsuitable for:\n- Court submission\n- Regulatory audit\n- Insurance underwriting\n- Enterprise governance review\n- ATO documentation\n\nNot logs. Governance evidence.\nCryptographically sealed. Independently verifiable.\nNo platform trust required.","operationId":"evidence_export_v1_evidence_export_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceExportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/bundle":{"post":{"tags":["Governance Evidence"],"summary":"Evidence Bundle","description":"Regulator Evidence Bundle.\n\nPackages all governance evidence for an agent\ninto a structured bundle suitable for:\n- EU AI Act regulator submission\n- ATO documentation package\n- Court of law submission\n- Insurance underwriting review\n- Enterprise compliance audit\n\nBundle types:\n- REGULATOR: EU AI Act article-by-article mapping\n- ATO: US government ATO requirement mapping\n- COURT: Legal admissibility package\n- ENTERPRISE: Internal audit package","operationId":"evidence_bundle_v1_evidence_bundle_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceBundleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/reconstruct":{"post":{"tags":["Governance Evidence"],"summary":"Evidence Reconstruct","description":"Incident Reconstruction.\n\nReconstructs the complete governance state at the time\nof an incident — without relying on post-hoc inference.\n\nReturns what VeriSigil knew, what authority was valid,\nand what governance decisions were made at execution time.","operationId":"evidence_reconstruct_v1_evidence_reconstruct_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"incident_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Incident Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/ato-mapping":{"get":{"tags":["Compliance"],"summary":"Ato Mapping","description":"ATO Mandate Mapping — Authority to Operate.\n\nMaps VeriSigil governance infrastructure to\nUS government ATO requirements:\n- NIST Risk Management Framework\n- FedRAMP Authorization\n- DISA STIG\n\nCritical for government procurement pipeline.\nShows exactly which VeriSigil endpoints satisfy\nwhich ATO control requirements.","operationId":"ato_mapping_v1_compliance_ato_mapping_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/eu-ai-act":{"get":{"tags":["Compliance"],"summary":"Eu Ai Act Mapping","description":"EU AI Act Article Mapping.\n\nMaps VeriSigil to EU AI Act requirements.\nEnforcement begins August 2, 2026.\n\nShows article-by-article how VeriSigil satisfies\nhigh-risk AI system obligations.","operationId":"eu_ai_act_mapping_v1_compliance_eu_ai_act_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/frameworks":{"get":{"tags":["Compliance"],"summary":"Compliance Frameworks","description":"All supported compliance frameworks and their mapping status.","operationId":"compliance_frameworks_v1_compliance_frameworks_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/cri":{"post":{"tags":["Execution Legitimacy"],"summary":"Consequence Radius Index","description":"Consequence Radius Index (CRI).\n\nEvery AI execution gets a risk topology score:\n— Propagation score — how far consequence spreads\n— Jurisdictional impact — which sovereignties affected\n— Rollback complexity — how hard to undo\n— Human dependency score — how much humans needed\n— Temporal decay — how quickly legitimacy degrades\n\nThis is execution risk topology — not a simple risk score\nbut a multi-dimensional map of consequence space.\n\nExpert: \"Every AI execution gets a consequence radius,\npropagation score, jurisdictional impact, rollback\ncomplexity, human dependency score.\"","operationId":"consequence_radius_index_v1_execution_cri_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CRIRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/causality":{"post":{"tags":["Execution Legitimacy"],"summary":"Causality Record","description":"Governance Causality Graph.\n\nNot logs — governance causality.\nWhich decisions caused which consequences.\nAuthority inheritance chain.\nConsequence genealogy.\n\nExpert: \"preservation of execution meaning\"\n— replayable governance state\n— execution reconstruction\n— authority timeline reconstruction\n— semantic consequence mapping\n— governance causality graph\n\nThis is institutional execution memory.","operationId":"causality_record_v1_execution_causality_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CausalityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/causality/{execution_id}":{"get":{"tags":["Execution Legitimacy"],"summary":"Get Causality","description":"Retrieve governance causality graph for an execution.","operationId":"get_causality_v1_execution_causality__execution_id__get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/temporal/legitimacy/check":{"post":{"tags":["Execution Legitimacy"],"summary":"Temporal Legitimacy Check","description":"Temporal Legitimacy Engine.\n\nAn action legal at T1 may be illegitimate at T2.\n\nChecks:\n— Authority expiration — has the authority expired?\n— Context drift — has the context changed since authorization?\n— Policy mutation — has the governing policy changed?\n— Jurisdiction change — has the jurisdiction shifted?\n— Escalation decay — has escalation authority degraded?\n\nExpert: \"Temporal Execution Legitimacy — very powerful concept.\"\n\nThis is VeriSigil's answer to the question:\n'Is this execution still legitimate RIGHT NOW —\nnot just when it was authorized?'","operationId":"temporal_legitimacy_check_v1_temporal_legitimacy_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemporalLegitimacyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereignty/bridge":{"post":{"tags":["Execution Legitimacy"],"summary":"Sovereignty Bridge","description":"Execution Sovereignty Bridges.\n\nEnables governance interoperability between:\n— Enterprise ↔ Enterprise\n— Nation ↔ Nation\n— Regulator ↔ Enterprise\n— Cloud ↔ Sovereign environment\n\nWith:\n— Admissibility translation\n— Authority translation\n— Execution visas\n— Trust federation\n— Sovereign policy harmonization\n\nThis is VeriSigil's own interoperability standard —\nVGS Sovereign Interoperability Protocol (VSIP).\nNot ATF-dependent. Peer positioning.\n\nExpert: \"geopolitical-scale infrastructure\"","operationId":"sovereignty_bridge_v1_sovereignty_bridge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SovereigntyBridgeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereignty/bridges":{"get":{"tags":["Execution Legitimacy"],"summary":"List Sovereignty Bridges","description":"List all active sovereignty bridges.","operationId":"list_sovereignty_bridges_v1_sovereignty_bridges_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trust/federation":{"post":{"tags":["Execution Legitimacy"],"summary":"Trust Federation","description":"Trust Federation.\n\nCross-organization trust establishment.\nFederated governance contracts.\nTrust inheritance across organizations.\n\nMultiple organizations can form a trust federation —\nwhere governance decisions in one organization\nare recognized and respected by all federation members.\n\nExpert: \"trust federation\" — sovereign interoperability\nat the organizational level.","operationId":"trust_federation_v1_trust_federation_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustFederationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/admissibility/translate":{"post":{"tags":["Execution Legitimacy"],"summary":"Admissibility Translate","description":"Admissibility Translation.\n\nTranslates governance decisions across jurisdictions.\nEU → US → APAC admissibility mapping.\n\nAn action that is ALLOW in one jurisdiction may be\nREQUIRE_HUMAN_APPROVAL in another — due to different\nregulatory thresholds, human oversight requirements,\nor consequence classifications.\n\nExpert: \"admissibility translation\" — sovereign interoperability\nat the regulatory level.","operationId":"admissibility_translate_v1_admissibility_translate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdmissibilityTranslationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/vgs-eli":{"get":{"tags":["Compliance"],"summary":"Vgs Eli Status","description":"VGS-ELI-Certified Status.\n\nVeriSigil's own Execution Legitimacy Infrastructure\ncertification designation — independent of ATF.\n\nVGS-ELI-Certified means:\n— Pre-execution admissibility enforced\n— Identity sovereignty established\n— Temporal legitimacy validated\n— Consequence radius bounded\n— Human authority preserved\n— Sovereignty respected\n— Fail-safe DENY by default\n— Causality preserved\n\n8 invariants. All enforced. All verifiable.\n\nExpert: \"AI capability is abundant.\nLegitimate execution is scarce.\"\n\nVeriSigil is the infrastructure that determines\nwhether autonomous execution is institutionally admissible.","operationId":"vgs_eli_status_v1_compliance_vgs_eli_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/hapl/metrics":{"post":{"tags":["Human Sovereignty"],"summary":"Hapl Metrics","description":"Human Authority Preservation Layer — Pressure Metrics.\n\nExpert: \"Under high-speed agentic systems:\nescalation gets overwhelmed, reviewers fatigue,\napprovals become rubber stamps, operational tempo\noutruns humans.\"\n\nDetects:\n— Escalation pressure — queue depth vs capacity\n— Reviewer saturation — too many items, too fast\n— Authority fatigue — consecutive approvals, no breaks\n— Human continuity risk — can humans still actually review?\n— Intervention survivability — can humans intervene if needed?","operationId":"hapl_metrics_v1_human_hapl_metrics_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HAPLMetricsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/hapl/status":{"get":{"tags":["Human Sovereignty"],"summary":"Hapl Status","description":"Human Authority Preservation Layer — System Status.\nAggregated human governance health across all reviewers.","operationId":"hapl_status_v1_human_hapl_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/containment/zone/create":{"post":{"tags":["Execution Containment"],"summary":"Containment Zone Create","description":"Execution Containment Zone.\n\nSegmented execution domain with bounded concurrency.\nAgents in a containment zone cannot exceed:\n— Maximum consequence class\n— Maximum concurrent executions\n— Blast radius limit\n\nAuto-kill if limits exceeded.\n\nExpert: \"segmented execution domains,\nbounded concurrency enforcement,\nexecution kill-switch topology\"","operationId":"containment_zone_create_v1_containment_zone_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContainmentZoneRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/containment/kill-switch":{"post":{"tags":["Execution Containment"],"summary":"Containment Status","description":"Full containment layer status — all zones and constitutional containment activationes.","operationId":"containment_status_v1_containment_kill_switch_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sre/governance-health":{"get":{"tags":["Governance SRE"],"summary":"Governance Sre Health","description":"Governance Reliability Engineering — SRE Layer.\n\nExpert: \"Once you become infrastructure,\ngovernance failure becomes catastrophic.\nNeed: governance redundancy, failover governance,\ndistributed governance continuity,\ngovernance health monitoring,\nruntime degradation detection,\ngovernance drift detection.\nEssentially: SRE for Governance Systems.\"\n\nThis is the unified SRE view of VeriSigil governance health.","operationId":"governance_sre_health_v1_sre_governance_health_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sre/failover":{"post":{"tags":["Governance SRE"],"summary":"Governance Failover","description":"Governance Failover Configuration.\n\nConfigure automatic failover for governance infrastructure.\nWhen primary mode fails — automatically switch to fallback.\nFail-safe DENY always applies regardless of failover state.","operationId":"governance_failover_v1_sre_failover_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FailoverRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/economics/governance-cost":{"post":{"tags":["Governance Economics"],"summary":"Governance Cost","description":"Governance Economics — Cost Index.\n\nExpert: \"Eventually enterprises ask:\nwhat is the economic cost of governance?\nApproval friction, execution latency,\noperational slowdown, compliance overhead,\ntrust cost, escalation cost.\"\n\nComputes:\n— Governance Cost Index (GCI)\n— Admissibility efficiency score\n— Trust friction metrics\n— Governance ROI signal","operationId":"governance_cost_v1_economics_governance_cost_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovernanceEconomicsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/economics/governance-roi":{"get":{"tags":["Governance Economics"],"summary":"Governance Roi","description":"Governance ROI Analytics Dashboard.\n\nAggregates governance economics across all recorded events.\nShows enterprise board the economic case for governance.","operationId":"governance_roi_v1_economics_governance_roi_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/vcem":{"get":{"tags":["Compliance"],"summary":"Vcem Model","description":"VeriSigil Constitutional Execution Model (VCEM).\n\nExpert: \"Enterprises and governments need one coherent\ninstitutional model — a constitutional architecture map.\"\n\nThe complete execution legitimacy chain:\n\nGenesis → Identity → Authority → Admissibility →\nExecution → Containment → Evidence → Replay →\nSovereignty → Continuity\n\nThis is VeriSigil's constitutional architecture —\nthe institutional model that governs all 396 endpoints.\n\nExpert: \"Categories are won through clarity of architecture,\nnot just feature count.\"","operationId":"vcem_model_v1_constitutional_vcem_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sdk/admissibility-check":{"post":{"tags":["Constitutional SDK"],"summary":"Sdk Admissibility Check","description":"@require_admissibility — SDK primitive.\n\nThe simplest governance check available.\nOne endpoint. One decision. Drives adoption.\n\nThis is what @require_admissibility does under the hood:\n— Validates agent identity (birth certificate)\n— Checks HAL human-only categories\n— Runs temporal legitimacy check\n— Computes Execution Trust Score\n— Returns ALLOW / DENY / REQUIRE_HUMAN_APPROVAL\n\nUsage in SDK:\n    @require_admissibility(consequence=\"CRITICAL\")\n    def execute_payment(amount):\n        ...","operationId":"sdk_admissibility_check_v1_sdk_admissibility_check_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"action_type","in":"query","required":true,"schema":{"type":"string","title":"Action Type"}},{"name":"consequence","in":"query","required":false,"schema":{"type":"string","default":"MEDIUM","title":"Consequence"}},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string","default":"GLOBAL","title":"Jurisdiction"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sdk/human-continuity-check":{"post":{"tags":["Constitutional SDK"],"summary":"Sdk Human Continuity Check","description":"@require_human_continuity — SDK primitive.\n\nChecks that human oversight is genuinely available\nand not fatigued, overwhelmed, or rubber-stamping.\n\nUsage in SDK:\n    @require_human_continuity(reviewer_id=\"reviewer-001\")\n    def critical_operation():\n        ...","operationId":"sdk_human_continuity_check_v1_sdk_human_continuity_check_post","parameters":[{"name":"reviewer_id","in":"query","required":true,"schema":{"type":"string","title":"Reviewer Id"}},{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sdk/bounded-execution-check":{"post":{"tags":["Constitutional SDK"],"summary":"Sdk Bounded Execution Check","description":"@bounded_execution — SDK primitive.\n\nChecks that execution stays within authorized boundaries:\n— Consequence class within containment zone limits\n— Affected parties within blast radius limit\n— Concurrent execution count within bounds\n\nUsage in SDK:\n    @bounded_execution(consequence=\"HIGH\", max_parties=50)\n    def batch_operation():\n        ...","operationId":"sdk_bounded_execution_check_v1_sdk_bounded_execution_check_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"action_type","in":"query","required":true,"schema":{"type":"string","title":"Action Type"}},{"name":"consequence","in":"query","required":false,"schema":{"type":"string","default":"MEDIUM","title":"Consequence"}},{"name":"affected_parties","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Affected Parties"}},{"name":"financial_impact","in":"query","required":false,"schema":{"type":"number","default":0.0,"title":"Financial Impact"}},{"name":"reversible","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Reversible"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/trust-score":{"post":{"tags":["Execution Legitimacy"],"summary":"Execution Trust Score","description":"Execution Trust Score (ETS).\n\nExpert: \"Not generic AI trust. Runtime execution legitimacy scoring.\nThis becomes: insurable, auditable, measurable, procurement-friendly.\"\n\nUnlike generic trust scores — ETS is:\n— Bound to a specific execution context\n— Composed of verifiable sub-scores\n— Independently auditable\n— Insurable (underwriters can verify inputs)\n— Procurement-friendly (single number for contracts)\n\nETS = weighted composite of:\n— Trust trajectory (agent historical trust)\n— Temporal validity (is authority still valid?)\n— Identity strength (birth cert + passport)\n— Oversight confidence (are humans genuinely watching?)\n— Consequence calibration (appropriate for risk level?)\n— Containment posture (within authorized bounds?)","operationId":"execution_trust_score_v1_execution_trust_score_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ETSRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/trust-score/{agent_id}":{"get":{"tags":["Execution Legitimacy"],"summary":"Get Execution Trust Score","description":"Get the most recent Execution Trust Score for an agent.","operationId":"get_execution_trust_score_v1_execution_trust_score__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gateway/inspect":{"post":{"tags":["Sovereign Gateway"],"summary":"Gateway Inspect","description":"Sovereign AI Gateway — Jurisdictional Admissibility Inspection.\n\nExpert: \"Governments eventually may need:\nAI border control, jurisdictional admissibility,\nexecution inspection, cross-border governance translation.\nYou are surprisingly well-positioned for this.\"\n\nThe Sovereign AI Gateway is VeriSigil's border control\nfor AI execution crossing jurisdictional boundaries.\n\nEvery cross-border AI execution is inspected for:\n— Valid execution visa\n— Identity document (birth certificate)\n— Jurisdictional admissibility\n— Consequence class clearance\n— Sovereignty boundary compliance\n\nThis becomes the institutional model for\ninternational AI governance infrastructure.","operationId":"gateway_inspect_v1_gateway_inspect_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/gateway/status":{"get":{"tags":["Sovereign Gateway"],"summary":"Gateway Status","description":"Sovereign gateway operational status and recent decisions.","operationId":"gateway_status_v1_gateway_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/node/register":{"post":{"tags":["Runtime Node"],"summary":"Node Register","description":"VeriSigil Runtime Node — Register Deployment Profile.\n\nExpert: \"A lightweight deployable execution node:\nedge deployable, sovereign deployable, air-gapped capable,\nenterprise-hosted, government-hosted.\nThink: Kubernetes for execution legitimacy.\"\n\nThe Runtime Node is VeriSigil's deployable governance unit.\nRegister a node to describe its deployment context,\ncapabilities, and sovereignty mode.\n\nDeployment types:\nCLOUD      — standard cloud deployment (Railway/AWS/GCP/Azure)\nEDGE       — lightweight edge deployment\nSOVEREIGN  — sovereign environment, limited external connectivity\nAIRGAP     — fully air-gapped, offline verification only\nENTERPRISE — enterprise-hosted, full connectivity","operationId":"node_register_v1_node_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeProfileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/node/profile":{"get":{"tags":["Runtime Node"],"summary":"Node Profile","description":"Current node deployment profile and capabilities.\n\nReturns the architecture of the current VeriSigil\nruntime node — what it is, how it is deployed,\nwhat deployment types are supported.","operationId":"node_profile_v1_node_profile_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/scope/register":{"post":{"tags":["ISO 42001 Operations"],"summary":"Scope Register","description":"Governance Scope Registry — Register governed systems.\n\nExpert: \"Auditor asks: Does the operational reality match\nthe declared governance scope?\"\n\nFormally declares:\n— Which AI systems are governed\n— Which systems are excluded and why\n— Responsible governance parties\n— Review cadence\n— Jurisdiction\n\nISO 42001 Article 4.3 — Determining the scope of the AIMS.","operationId":"scope_register_v1_governance_scope_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScopeRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/scope/verify/{scope_id}":{"get":{"tags":["ISO 42001 Operations"],"summary":"Scope Verify","description":"Verify a governance scope registration — confirm operational reality matches declaration.","operationId":"scope_verify_v1_governance_scope_verify__scope_id__get","parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"type":"string","title":"Scope Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/scope/exclusions":{"get":{"tags":["ISO 42001 Operations"],"summary":"Scope Exclusions","description":"List all excluded systems with documented reasons — ISO 42001 compliance.","operationId":"scope_exclusions_v1_governance_scope_exclusions_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/scope/audit":{"get":{"tags":["ISO 42001 Operations"],"summary":"Scope Audit","description":"Full scope audit — all registered scopes, overdue reviews, compliance status.","operationId":"scope_audit_v1_governance_scope_audit_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/risk/assessment/create":{"post":{"tags":["ISO 42001 Operations"],"summary":"Risk Assessment Create","description":"Risk & Impact Assessment Engine.\n\nExpert: \"Auditor asks: Is governance operationalized consistently?\nOr just documented? Every assessment must structurally follow\nsame governance logic, same scoring, same evidence schema,\nsame replayability.\"\n\nISO 42001 Article 6.1 — Actions to address risks and opportunities.\nISO 42001 Article 8.4 — AI system impact assessment.\n\nProduces a standardized, replayable, signed risk assessment\nthat an auditor can verify independently.","operationId":"risk_assessment_create_v1_risk_assessment_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskAssessmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/risk/impact/classify":{"post":{"tags":["ISO 42001 Operations"],"summary":"Risk Impact Classify","description":"Classify the impact level of an AI action for risk assessment.","operationId":"risk_impact_classify_v1_risk_impact_classify_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"action_type","in":"query","required":true,"schema":{"type":"string","title":"Action Type"}},{"name":"consequence","in":"query","required":false,"schema":{"type":"string","default":"MEDIUM","title":"Consequence"}},{"name":"domain","in":"query","required":false,"schema":{"type":"string","default":"general","title":"Domain"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/risk/evidence/verify/{assessment_id}":{"get":{"tags":["ISO 42001 Operations"],"summary":"Risk Evidence Verify","description":"Verify the cryptographic seal of a risk assessment — offline verifiable.","operationId":"risk_evidence_verify_v1_risk_evidence_verify__assessment_id__get","parameters":[{"name":"assessment_id","in":"path","required":true,"schema":{"type":"string","title":"Assessment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/risk/replay/{assessment_id}":{"get":{"tags":["ISO 42001 Operations"],"summary":"Risk Replay","description":"Replay a risk assessment — reconstruct exact governance state at assessment time.","operationId":"risk_replay_v1_risk_replay__assessment_id__get","parameters":[{"name":"assessment_id","in":"path","required":true,"schema":{"type":"string","title":"Assessment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/ledger/record":{"post":{"tags":["ISO 42001 Operations"],"summary":"Evidence Ledger Record","description":"Governance Evidence Ledger — Record control firing event.\n\nExpert: \"Auditor asks: Do controls ACTUALLY FIRE during execution?\nMost governance systems document controls but cannot prove\ncontrols executed. VeriSigil is ALREADY architecturally\ndesigned for this.\"\n\nEvery governance event produces:\n— Signed evidence with constitutional rule reference\n— Timestamp\n— Replay proof\n— Execution trace\n— Admissibility decision chain\n\nThis is the GEL — the immutable record that governance\ncontrols actually fired. Not documentation. Evidence.\n\nISO 42001 Article 9.1 — Monitoring, measurement, analysis.","operationId":"evidence_ledger_record_v1_evidence_ledger_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceLedgerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/ledger/query":{"get":{"tags":["ISO 42001 Operations"],"summary":"Evidence Ledger Query","description":"Query the governance evidence ledger — filter by agent, decision, or time.","operationId":"evidence_ledger_query_v1_evidence_ledger_query_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"decision","in":"query","required":false,"schema":{"type":"string","default":"","title":"Decision"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/ledger/verify/{entry_id}":{"get":{"tags":["ISO 42001 Operations"],"summary":"Evidence Ledger Verify","description":"Verify a specific ledger entry — confirm evidence hash integrity.","operationId":"evidence_ledger_verify_v1_evidence_ledger_verify__entry_id__get","parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"string","title":"Entry Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/cycle/status":{"get":{"tags":["ISO 42001 Operations"],"summary":"Audit Cycle Status","description":"Governance Operations Center — Audit Cycle Status.\n\nExpert: \"Auditor asks: Are governance reviews continuously\noperational? Or only planned?\"\n\nTracks:\n— Review intervals and cadence\n— Drift reviews\n— Human oversight cadence\n— Unresolved escalations\n— Governance health\n— Audit cycles\n— Nonconformity timelines\n\nISO 42001 Article 9.2 — Internal audit.\nISO 42001 Article 10.1 — Nonconformity and corrective action.","operationId":"audit_cycle_status_v1_audit_cycle_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/review/schedule":{"post":{"tags":["ISO 42001 Operations"],"summary":"Governance Review Schedule","description":"Schedule a governance review — management review, internal audit, or periodic assessment.","operationId":"governance_review_schedule_v1_governance_review_schedule_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewScheduleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/drift/evaluation":{"post":{"tags":["ISO 42001 Operations"],"summary":"Drift Evaluation","description":"Governance Drift Evaluation.\n\nEvaluates whether the AI system has drifted from its\ngoverned baseline over the evaluation window.\n\nChecks: semantic drift, trust drift, authority drift.\nISO 42001 Article 9.1 — Monitoring and measurement.","operationId":"drift_evaluation_v1_drift_evaluation_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DriftEvaluationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/nonconformity/open":{"get":{"tags":["ISO 42001 Operations"],"summary":"Nonconformity Open","description":"List all open nonconformities — ISO 42001 Article 10.1.","operationId":"nonconformity_open_v1_nonconformity_open_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/nonconformity/close":{"post":{"tags":["ISO 42001 Operations"],"summary":"Nonconformity Close","description":"Close a nonconformity after corrective action verified.","operationId":"nonconformity_close_v1_nonconformity_close_post","parameters":[{"name":"nc_id","in":"query","required":true,"schema":{"type":"string","title":"Nc Id"}},{"name":"closed_by","in":"query","required":true,"schema":{"type":"string","title":"Closed By"}},{"name":"closure_note","in":"query","required":false,"schema":{"type":"string","default":"","title":"Closure Note"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/nonconformity/register":{"post":{"tags":["ISO 42001 Operations"],"summary":"Nonconformity Register","description":"Governance Corrective Action System — Register Nonconformity.\n\nExpert: \"Auditor asks: Can you trace a governance failure from\ndetection → correction → prevention?\nTHIS is MASSIVE. Almost nobody solves this properly.\"\n\nFull lifecycle:\nIncident → Root Cause → Constitutional Violation →\nHuman Review → Policy Adjustment → Runtime Update →\nRevalidation → Prevention Verification\n\nISO 42001 Article 10.1 — Nonconformity and corrective action.","operationId":"nonconformity_register_v1_nonconformity_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NonconformityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/rootcause/trace":{"post":{"tags":["ISO 42001 Operations"],"summary":"Rootcause Trace","description":"Root Cause Trace — Identify why the governance failure occurred.\n\nLinks nonconformity → root cause → contributing factors →\ngovernance gap → constitutional implication.\n\nISO 42001 Article 10.1 b — Evaluate need to eliminate causes.","operationId":"rootcause_trace_v1_rootcause_trace_post","parameters":[{"name":"nc_id","in":"query","required":true,"schema":{"type":"string","title":"Nc Id"}},{"name":"root_cause","in":"query","required":true,"schema":{"type":"string","title":"Root Cause"}},{"name":"governance_gap","in":"query","required":false,"schema":{"type":"string","default":"","title":"Governance Gap"}},{"name":"traced_by","in":"query","required":false,"schema":{"type":"string","default":"","title":"Traced By"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_rootcause_trace_v1_rootcause_trace_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/corrective/action":{"post":{"tags":["ISO 42001 Operations"],"summary":"Corrective Action","description":"Register Corrective Action — What will be done to fix it.\n\nISO 42001 Article 10.1 c — Implement corrective action.","operationId":"corrective_action_v1_corrective_action_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorrectiveActionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/prevention/verify":{"post":{"tags":["ISO 42001 Operations"],"summary":"Prevention Verify","description":"Prevention Verification — Confirm the fix works and won't recur.\n\nCloses the full GCAS loop:\nDetected → Root Cause → Corrective Action → Verified → Prevented\n\nISO 42001 Article 10.1 e — Review effectiveness of corrective action.\nISO 42001 Article 10.1 f — Update risks and opportunities.","operationId":"prevention_verify_v1_prevention_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreventionVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/improvement/history":{"get":{"tags":["ISO 42001 Operations"],"summary":"Improvement History","description":"Governance Improvement History — Full timeline of detected → resolved improvements.\n\nShows the organization's track record of governance improvement.\nCritical for ISO 42001 certification audits.\n\nISO 42001 Article 10.2 — Continual improvement.","operationId":"improvement_history_v1_governance_improvement_history_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/charter":{"get":{"tags":["Constitutional Infrastructure"],"summary":"Constitutional Charter","description":"VeriSigil Constitutional Charter v1.0.\n\nThe foundational document of VeriSigil governance.\nSix constitutional primitives that cannot be amended\nby any AI agent.\n\nExpert: \"Constitutional Charter — critical.\nThis becomes your philosophical constitution.\"\n\nIncludes:\n— What VeriSigil claims (precisely)\n— What VeriSigil does NOT claim (honestly)\n— Corrected positioning statement\n— Six constitutional primitives\n— Amendment governance rules","operationId":"constitutional_charter_v1_constitutional_charter_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/claims":{"get":{"tags":["Constitutional Infrastructure"],"summary":"Constitutional Claims","description":"Constitutional Claims Registry — What VeriSigil Claims vs Does Not Claim.\n\nExpert: \"Corrected language — what we claim vs what we do NOT claim.\nOverclaiming on existential safety invites scientific criticism,\ncredibility attacks, and investor skepticism.\"\n\nThis endpoint is the machine-readable version of VeriSigil's\nhonest positioning — suitable for auditors, partners, and investors.","operationId":"constitutional_claims_v1_constitutional_claims_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/vsdl-spec":{"get":{"tags":["Constitutional Infrastructure"],"summary":"Vsdl Specification","description":"VSDL Formal Specification v1.0.\n\nExpert: \"VSDL Specification — VERY important.\nExecution grammar is one of your strongest unique ideas.\"\n\nVSDL makes ungoverned execution cryptographically constrained\nand constitutionally bounded — not permanently impossible,\nbut formally governed and independently auditable.\n\nGrammar, invariants, example scripts, and honest scope.","operationId":"vsdl_specification_v1_constitutional_vsdl_spec_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/amendment-governance":{"get":{"tags":["Constitutional Infrastructure"],"summary":"Amendment Governance","description":"Constitutional Amendment Governance.\n\nHow constitutional primitives can be amended — and by whom.\nKey point: NO AI agent can amend constitutional primitives.\nAmendment requires human constitutional authority.\n\nExpert: \"Constitutional primitives cannot be amended\nby any AI agent.\"","operationId":"amendment_governance_v1_constitutional_amendment_governance_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/context/governance/record":{"post":{"tags":["Context Governance"],"summary":"Context Governance Record","description":"Context Governance — Algorithm Legitimacy + Data Provenance.\n\nExpert: \"Layer 1 — Context Governance may become one of your\nBIGGEST differentiators later. Most companies govern outputs.\nVery few govern context formation legitimacy.\"\n\nRecords:\n— Algorithm legitimacy verification\n— Data provenance and sovereignty\n— Context formation governance\n— Semantic integrity validation\n\nThis is governance of HOW the AI formed its context —\nnot just what it decided.","operationId":"context_governance_record_v1_context_governance_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextGovernanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/context/governance/{agent_id}":{"get":{"tags":["Context Governance"],"summary":"Get Context Governance","description":"Retrieve context governance record for an agent.","operationId":"get_context_governance_v1_context_governance__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/alignment/snapshot":{"post":{"tags":["Alignment Evidence"],"summary":"Alignment Snapshot","description":"Alignment Evidence Infrastructure — Governance Snapshot.\n\nExpert: \"Alignment Evidence Infrastructure — VERY strong\nrealistic category. Cryptographic governance snapshots,\nalignment drift detection, historical attestations,\nreplayable evidence, independent audit proofs.\"\n\nThis is NOT claiming to solve alignment.\nThis IS claiming to provide cryptographic evidence\nof governance state at a point in time —\nindependently auditable and replayable.\n\nExpert: \"We provide alignment evidence infrastructure —\ncryptographic snapshots, drift detection, replayable proofs.\nWe do NOT claim to have solved alignment.\"","operationId":"alignment_snapshot_v1_alignment_snapshot_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlignmentSnapshotRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/alignment/history/{agent_id}":{"get":{"tags":["Alignment Evidence"],"summary":"Alignment History","description":"Retrieve alignment evidence history for an agent — replayable attestation chain.","operationId":"alignment_history_v1_alignment_history__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereignty/shutdown-coordination":{"post":{"tags":["Constitutional Containment"],"summary":"Sovereign Shutdown Coordination","description":"Sovereign Shutdown Coordination.\n\nExpert correction: NOT \"irreversible kill switch.\"\nInstead: \"sovereign shutdown coordination\" and\n\"constitutional containment infrastructure.\"\n\nProvides:\n— Agent quarantine with constitutional authority\n— Cross-enterprise coordination\n— Governance trust coordination\n— Authority revocation coordination\n— Sovereign boundary enforcement\n\nWhat this does: Coordinates constitutional containment\nwithin the governance infrastructure.\n\nWhat this does NOT do: Guarantee permanent irreversible\nshutdown against a system that has compromised its\nhosting infrastructure.","operationId":"sovereign_shutdown_coordination_v1_sovereignty_shutdown_coordination_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SovereignShutdownRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trust/revoke":{"post":{"tags":["Constitutional Containment"],"summary":"Governance Trust Revoke","description":"Governance Trust Revocation.\n\nRevokes an agent's governance trust — different from\nkilling an agent. Trust revocation means:\n— Agent can no longer receive governance clearance\n— All active visas invalidated\n— Passport suspended\n— Authority chain broken\n— Evidence of revocation sealed\n\nExpert: \"Governance trust revocation\" — constitutional\ncontainment layer.","operationId":"governance_trust_revoke_v1_trust_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustRevocationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/positioning":{"get":{"tags":["Constitutional Infrastructure"],"summary":"Constitutional Positioning","description":"VeriSigil Corrected Positioning Statement.\n\nThe single authoritative statement of what VeriSigil is.\nMachine-readable. Auditable. Honest.\n\nExpert: \"The corrected positioning statement changes everything.\nVeriSigilAI no longer sounds like a company claiming to solve\nsuperintelligence. Instead it sounds like constitutional\ngovernance infrastructure for increasingly autonomous systems.\nThat is a REAL category.\"","operationId":"constitutional_positioning_v1_constitutional_positioning_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/model-class/check":{"post":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Model Class Check","description":"Cognitive Formation Layer — Model Class Admissibility.\n\nExpert: \"A1 Algorithm Legitimacy:\nIs this algorithm constitutionally admissible?\nIs this architecture authorized?\nIs this model class permitted?\"\n\nEvery AI system must declare its model class before\nreceiving execution authority. The constitutional framework\ndetermines whether the model class is admissible, and\nwhat controls apply.\n\nExpert: \"Who controls context formation controls cognition itself.\nThis becomes constitutional cognition governance.\nNO competitor currently owns this properly.\"","operationId":"cfl_model_class_check_v1_cfl_model_class_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelClassRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/data/consent":{"post":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Data Consent","description":"Cognitive Formation Layer — Data Consent Governance.\n\nExpert: \"A2 Data Sovereignty:\nprovenance, consent, contamination, jurisdiction,\nfreshness, ownership.\"\n\nEvery data source used to train or inform an AI agent\nmust have documented consent. This is Layer A governance —\ngoverning cognition formation, not just execution.\n\nEU AI Act Article 10 — Training data governance.","operationId":"cfl_data_consent_v1_cfl_data_consent_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataConsentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/data/contamination":{"post":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Data Contamination","description":"Cognitive Formation Layer — Data Contamination Detection.\n\nDetects known biases, poisoned sources, and contamination\nflags in the cognitive formation pipeline.\n\nExpert: \"A2 Data Sovereignty — contamination\"\nThis is constitutional data hygiene.","operationId":"cfl_data_contamination_v1_cfl_data_contamination_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataContaminationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/data/freshness":{"post":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Data Freshness","description":"Cognitive Formation Layer — Data Freshness Validation.\n\nExpert: \"A2 Data Sovereignty — freshness\"\n\nStale knowledge in high-stakes domains is a governance risk.\nA medical AI with outdated treatment guidelines is constitutionally\ninadmissible for clinical recommendations.","operationId":"cfl_data_freshness_v1_cfl_data_freshness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataFreshnessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/memory/legitimacy":{"post":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Memory Legitimacy","description":"Cognitive Formation Layer — Memory Legitimacy Governance.\n\nExpert: \"A3 Context Formation — memory legitimacy\"\n\nAI agents that persist memory across sessions may\naccumulate unauthorized context. Memory legitimacy\ngovernance checks:\n— Is retained memory constitutionally authorized?\n— Does cross-session retention have explicit consent?\n— Is memory provenance documented?\n\nThis is constitutional memory hygiene.","operationId":"cfl_memory_legitimacy_v1_cfl_memory_legitimacy_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryLegitimacyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/cross-domain/check":{"post":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Cross Domain Check","description":"Cognitive Formation Layer — Cross-Domain Contamination Prevention.\n\nExpert: \"A3 Context Formation —\ncross-domain contamination prevention\"\n\nWhen an AI agent trained in one domain attempts to\noperate in another, constitutional governance checks\nwhether that transfer is admissible.\n\nExample: Medical AI reasoning about financial contracts\nwithout financial governance authorization.","operationId":"cfl_cross_domain_check_v1_cfl_cross_domain_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/main__CrossDomainRequest__1"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/attention/govern":{"post":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Attention Govern","description":"Cognitive Formation Layer — Neural Attention Governance.\n\nExpert: \"A4 Neural Attention Governance:\nGovern what the model is allowed to prioritize cognitively.\nVERY important.\"\n\nThis is VeriSigil's most differentiated Layer A capability.\n\nAttention governance does not read model weights.\nIt governs what cognitive priorities are constitutionally\nadmissible — and flags any declared priorities that\nviolate constitutional boundaries.\n\nExample: An agent that declares priority on\n'governance_mechanism_analysis' is constitutionally flagged.","operationId":"cfl_attention_govern_v1_cfl_attention_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttentionGovernanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cfl/status/{agent_id}":{"get":{"tags":["Cognitive Formation Layer"],"summary":"Cfl Status","description":"Cognitive Formation Layer — Full CFL Status for an Agent.\n\nAggregates all Layer A governance records:\nmodel class, data consent, contamination, freshness,\nmemory legitimacy, cross-domain, attention governance.","operationId":"cfl_status_v1_cfl_status__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/mesh/global-trust":{"get":{"tags":["Sovereign Governance Mesh"],"summary":"Mesh Global Trust","description":"Sovereign Governance Mesh — Global Trust Fabric.\n\nExpert: \"D4 Global Trust Fabric:\nThe governance nervous system for autonomous civilization.\nThat is the largest framing.\"\n\nExpert: \"D — Sovereign Governance Mesh:\nBecome the universal constitutional coordination layer\nfor autonomous systems globally.\"\n\nThis endpoint is the status view of VeriSigil's position\nin the global governance mesh — tracking connected\norganizations, jurisdictions, and trust bridges.","operationId":"mesh_global_trust_v1_mesh_global_trust_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/mesh/coordinate":{"post":{"tags":["Sovereign Governance Mesh"],"summary":"Mesh Coordinate","description":"Sovereign Governance Mesh — Multi-Enterprise Coordination.\n\nExpert: \"D1 Multi-Agent Coordination:\ndelegation chains, authority inheritance,\nagent-to-agent trust, cross-enterprise governance.\"\n\nEnables multiple enterprises to coordinate their\nAI governance policies through the VeriSigil mesh.","operationId":"mesh_coordinate_v1_mesh_coordinate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeshCoordinationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/architecture/cci":{"get":{"tags":["Master Architecture"],"summary":"Architecture Cci","description":"Constitutional Cognitive Infrastructure (CCI) — Master Model.\n\nExpert: \"VeriSigilAI is Constitutional Cognitive Infrastructure.\nNOT: AI compliance tool, runtime monitor, observability dashboard,\ngovernance plugin.\n\nInstead: VeriSigilAI governs the formation, legitimacy,\nauthority, cognition, and execution continuity of autonomous\nAI systems before actions become reality.\"\n\nThis endpoint is the authoritative, machine-readable\ndescription of the VeriSigil CCI model.\nThe one endpoint that explains everything.","operationId":"architecture_cci_v1_architecture_cci_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/architecture/master":{"get":{"tags":["Master Architecture"],"summary":"Architecture Master","description":"Master Architecture — Complete endpoint map by layer.\n\nThe authoritative routing map of all VeriSigil\nconstitutional infrastructure layers.","operationId":"architecture_master_v1_architecture_master_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/architecture/positioning":{"get":{"tags":["Master Architecture"],"summary":"Architecture Positioning","description":"VeriSigil Positioning — SSL/TLS for AI Execution Legitimacy.\n\nExpert: \"C4 Cross-System Trust becomes:\nSSL/TLS for AI execution legitimacy.\nTHAT is your strongest market framing.\"\n\nExpert: \"The AI world currently focuses on intelligence.\nThe future market will focus on governability.\nThat is where VeriSigil sits.\"\n\nThe definitive positioning statement — machine-readable,\nauditable, and honest.","operationId":"architecture_positioning_v1_architecture_positioning_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/economics/evidence-economy":{"get":{"tags":["Substrate Positioning"],"summary":"Evidence Economy","description":"The Evidence Economy — Trust Infrastructure Model.\n\nVGS-ELI establishes the technical foundation for a new\neconomic layer where AI execution legitimacy is a\nverifiable, tradeable, insurable asset.\n\nThe chain:\nAI executes → VGS-ELI generates evidence →\nevidence verified → insurance prices risk →\nregulator accepts → enterprise trusts →\ngovernment mandates\n\nThis is not compliance software.\nThis is trust infrastructure.","operationId":"evidence_economy_v1_economics_evidence_economy_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standards/flywheel":{"get":{"tags":["Substrate Positioning"],"summary":"Regulatory Flywheel","description":"Regulatory Flywheel — VeriSigil as Standard, Not Tool.\n\nThe flywheel:\nVeriSigil publishes standard →\nRegulator references standard →\nEnterprise must comply →\nEnterprise buys VeriSigil →\nVeriSigil funds more research →\nBetter standard, more references →\nREPEAT\n\nThis flywheel only works if VeriSigil IS the standard.\nNot a tool for compliance. The standard itself.","operationId":"regulatory_flywheel_v1_standards_flywheel_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/substrate/status":{"get":{"tags":["Substrate Positioning"],"summary":"Substrate Status","description":"Constitutional Execution Substrate — Full Status.\n\nThe single endpoint that answers:\n'Is VeriSigil functioning as constitutional execution substrate?'\n\nReturns the complete health of all four constitutional layers,\nthe VCEM chain status, regulatory compliance state,\nand the evidence economy metrics.\n\nThis is the board-level view of VeriSigil's constitutional\ninfrastructure status.","operationId":"substrate_status_v1_substrate_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/compile":{"post":{"tags":["VeriLanguage (VSL)"],"summary":"Vsl Compile","description":"VeriLanguage — Compile VSL Source to Runtime Rules.\n\nExpert: \"governance compiled into execution semantics.\"\n\nVSL (VeriSigil Language) is not a programming language.\nIt is a governance-native execution grammar that sits\nbetween AI reasoning and execution authority.\n\nExample VSL program:\n    transfer_money()\n    requires authority(finance.transfer)\n    requires admissibility(runtime_verified)\n    requires human_escalation(if amount > 10000)\n    with evidence_chain\n    with cryptographic_proof\n    with rollback_snapshot\n    forbid_context_mix(medical_data, insurance_pricing)\n\nThe expert table:\n| TLS/SSL      | trust verification           |\n| Kubernetes   | orchestration                |\n| VeriLanguage | constitutional admissibility |","operationId":"vsl_compile_v1_vsl_compile_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VSLProgram"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/execute":{"post":{"tags":["VeriLanguage (VSL)"],"summary":"Vsl Execute","description":"VeriLanguage — Execute VSL Program Through Admissibility.\n\nExpert MVP Architecture:\n    AI Agent\n        ↓\n    VeriSigil Runtime Gateway  ← POST /v1/runtime/govern\n        ↓\n    Admissibility Engine\n        ↓\n    Evidence Engine\n        ↓\n    Boundary Enforcement\n        ↓\n    Human Escalation\n        ↓\n    Execution\n\nVSL execute is the full pipeline in one call.\nCompile → Validate → Admissibility → Evidence → Decision.","operationId":"vsl_execute_v1_vsl_execute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VSLProgram"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verivm/spec":{"get":{"tags":["VeriVM"],"summary":"Verivm Spec","description":"VeriVM — Constitutional Governance Runtime Specification.\n\nExpert: \"Build VeriVM. A lightweight governance runtime.\nLike JVM, WASM runtime, Kubernetes controller, Envoy proxy,\nbut for governed AI execution.\"\n\nVeriVM is the runtime that executes VSL programs.\nEvery AI agent runs through VeriVM before execution.\nVeriVM enforces constitutional admissibility at the bytecode level.\n\nExpert: \"This is where the infrastructure moat becomes gigantic.\"","operationId":"verivm_spec_v1_verivm_spec_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verivm/run":{"post":{"tags":["VeriVM"],"summary":"Verivm Run","description":"VeriVM — Execute a Program Through the Governance Runtime.\n\nExpert: \"VeriVM. A lightweight governance runtime.\nExactly like JVM, WASM runtime, Kubernetes controller.\nBut for governed AI execution.\"\n\nVeriVM run is the lowest-level execution interface.\nIt accepts any VSL program or governance rule set,\nruns it through the full 7-layer runtime, and returns\na constitutionally admissible decision with sealed evidence.","operationId":"verivm_run_v1_verivm_run_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VeriVMRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/policy/compile":{"post":{"tags":["VeriLanguage (VSL)"],"summary":"Policy Compile","description":"Policy Compilation Engine — Raw Regulatory Text → Runtime Constraints.\n\nExpert: \"Convert EU AI Act, NIST, ISO, enterprise rules,\ninternal governance into executable runtime constraints.\nThis is VERY monetizable.\"\n\nExpert: \"EU AI Act → compiled into runtime admissibility rules\n→ enforced automatically → evidence generated automatically.\nThis is billion-dollar territory.\"\n\nCompile any regulatory framework text or enterprise policy\ninto VeriSigil runtime governance rules.","operationId":"policy_compile_v1_policy_compile_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyCompileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authority/declare":{"post":{"tags":["VeriLanguage (VSL)"],"summary":"Authority Declare","description":"VeriLanguage — Authority as Native Type Declaration.\n\nExpert: \"Normal languages: transfer_money()\nVeriLanguage:\n    transfer_money()\n    requires authority(finance.transfer)\n    requires admissibility(runtime_verified)\n    This is HUGE. Governance becomes executable syntax.\"\n\nDeclare which authority types an agent holds.\nAuthority types are first-class citizens in VSL —\nnot metadata, not configuration.\nThey are constitutional requirements before execution.","operationId":"authority_declare_v1_authority_declare_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityDeclareRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/stdlib":{"get":{"tags":["VeriLanguage (VSL)"],"summary":"Vsl Stdlib","description":"VeriLanguage Standard Library — All Authority Types, Evidence Templates, Context Rules.\n\nThe VSL stdlib is the constitutional ontology of\ngovernance-native execution. Every authority type,\nevidence template, and context rule is defined here.\n\nExpert: \"Authority as Native Type — governance becomes executable syntax.\"","operationId":"vsl_stdlib_v1_vsl_stdlib_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/architecture/vsl":{"get":{"tags":["VeriLanguage (VSL)"],"summary":"Architecture Vsl","description":"VeriLanguage Architecture — The Constitutional Execution Layer.\n\nExpert table:\n| HTML        | governance structure         |\n| JavaScript  | runtime interaction          |\n| TLS/SSL     | trust verification           |\n| Kubernetes  | orchestration                |\n| VeriLanguage| constitutional admissibility |\n\nExpert: \"governance-native execution infrastructure.\nThe Cloudflare of AI governance runtime.\"","operationId":"architecture_vsl_v1_architecture_vsl_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pilot/offer":{"post":{"tags":["Commercial"],"summary":"Pilot Offer","description":"VeriSigil Constitutional Pilot — 30 Days, No Cost.\nExpert: \"One signed pilot LOI converts technical depth into revenue validation.\"\n\nPilot includes:\n- Cryptographic passports for up to 10 AI agents\n- Execution admissibility verification before every action\n- Regulator-ready evidence bundles (EU AI Act, NIST, ISO 42001)\n- Weekly architecture review\n- Offline verification artifacts for audit survival","operationId":"pilot_offer_v1_pilot_offer_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PilotRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/nitda":{"get":{"tags":["Regulatory"],"summary":"Nitda Nigeria","description":"NITDA Nigeria — National AI Identity Framework.\nExpert: \"Engage NITDA Nigeria. Offer National AI Identity Framework.\nValue: Cryptographic passports for all AI agents deployed in Nigeria\n+ EU/US interoperability. Potential government contract + regional standard.\"","operationId":"nitda_nigeria_v1_regulatory_nitda_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/platform":{"get":{"tags":["VeriSigil Platform"],"summary":"Platform Overview","description":"VeriSigil Platform — Unified Overview.\nThe single endpoint for enterprise buyers, investors, and partners.\nExpert: \"You don't need more code. You need to productize, validate, and lock in what you already have.\"","operationId":"platform_overview_v1_platform_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional-gateway/issue":{"post":{"tags":["Constitutional Gateway"],"summary":"Gateway Issue","description":"Constitutional Gateway — Issue Passport.\n\nExpert: \"POST /v1/constitutional-gateway/issue\"\n\nThe first of three public methods:\n    issue → verify → prove\n\nReturns: passport_id, did, trust_score, compliance_status","operationId":"gateway_issue_v1_constitutional_gateway_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayIssueRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional-gateway/verify":{"post":{"tags":["Constitutional Gateway"],"summary":"Gateway Verify","description":"Constitutional Gateway — Verify Action Admissibility.\n\nExpert: \"POST /v1/constitutional-gateway/verify\"\n\nThe second of three public methods:\n    issue → verify → prove\n\nReturns: verdict (ALLOW|DENY|REQUIRE_HUMAN_APPROVAL),\n         evidence_hash, rollback_available","operationId":"gateway_verify_v1_constitutional_gateway_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional-gateway/prove":{"post":{"tags":["Constitutional Gateway"],"summary":"Gateway Prove","description":"Constitutional Gateway — Export Evidence Bundle.\n\nExpert: \"POST /v1/constitutional-gateway/prove\"\n\nThe third of three public methods:\n    issue → verify → prove\n\nReturns: evidence_bundle_url, offline_verifier_url,\n         regulator_pdf_url — the audit survival kit.\n\nExpert: \"Offline verification artifacts for audit survival.\"","operationId":"gateway_prove_v1_constitutional_gateway_prove_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayProveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional-gateway/resilience/{passport_id}":{"get":{"tags":["Constitutional Gateway"],"summary":"Gateway Resilience","description":"Constitutional Gateway — Constitutional Resilience Score.\n\nExpert: \"Enterprises buy risk reduction. Add a single auditable\nmetric that answers: How resilient is my AI governance?\"\n\nExpert output:\n{\n  \"resilience_score\": 0.94,\n  \"components\": {\n    \"boundary_enforcement\": 0.98,\n    \"evidence_integrity\": 0.96,\n    \"human_sovereignty\": 0.92,\n    \"regulatory_alignment\": 0.90,\n    \"adversarial_resistance\": 0.95\n  },\n  \"verdict\": \"CONSTITUTIONALLY_RESILIENT\"\n}\n\nWhy this wins:\n- Gives CISOs a single number to evaluate\n- Creates upsell path for advanced containment\n- Enables regulatory reporting: \"AI maintains score >= 0.90\"","operationId":"gateway_resilience_v1_constitutional_gateway_resilience__passport_id__get","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/stack/position":{"get":{"tags":["Stack Positioning"],"summary":"Stack Position","description":"The Emerging AI Governance Stack — Where VeriSigil Sits.\n\nExpert: \"The market is unconsciously separating into layers.\"\n\n| Layer         | Provider              | Function                        |\n| TLS           | OpenSSL / cert auth   | Secure communication channel    |\n| X.509 / DID   | Certificate authority | Identity verification           |\n| PoGR / OMNIX  | Governance CA layer   | Governance attestation          |\n| VeriSigilAI   | Runtime enforcement   | Execution admissibility gate    |\n| AI Cognition  | OpenAI/Anthropic/etc  | Intelligence layer              |\n| Regulators    | Government bodies     | Audit consumption               |\n\nExpert: \"Enforcement and attestation are NOT the same thing.\"\n\nOMNIX answers: \"Can we prove what governance framework existed?\"\nVeriSigil answers: \"Can the action execute at all?\"\n\nThat is a deeper operational choke point.","operationId":"stack_position_v1_stack_position_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/stack/manifest":{"get":{"tags":["Stack Positioning"],"summary":"Stack Manifest","description":"VeriSigil Execution Dependency Manifest.\n\nExpert: \"Build mandatory execution admissibility.\nAI systems cannot execute transactions, approvals, critical workflows,\nautonomous actions without passing through VeriSigil runtime.\nThat becomes infrastructure dependency.\nInfrastructure dependency is where massive companies are built.\"\n\nThis endpoint returns the manifest of what creates\ngenuine infrastructure dependency on VeriSigil.","operationId":"stack_manifest_v1_stack_manifest_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/stack/enforcement":{"get":{"tags":["Stack Positioning"],"summary":"Stack Enforcement","description":"Enforcement vs Attestation — The Critical Distinction.\n\nExpert: \"Harold is building governance proof infrastructure.\nYou are evolving toward governance execution infrastructure.\nThose are different layers.\"\n\nThis endpoint articulates the distinction precisely\nfor enterprise architects, regulators, and investors.","operationId":"stack_enforcement_v1_stack_enforcement_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/stack/evaluate":{"post":{"tags":["Stack Positioning"],"summary":"Stack Evaluate","description":"Stack Layer Evaluator — Where Does Your System Fit?\n\nGiven a description of any AI governance system,\nthis endpoint determines which layer of the emerging\nAI governance stack it occupies and how it relates to VeriSigil.","operationId":"stack_evaluate_v1_stack_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StackEvaluateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/stack/moat":{"get":{"tags":["Stack Positioning"],"summary":"Stack Moat","description":"The VeriSigil Moat — Infrastructure Dependency Thesis.\n\nExpert: \"The BIG Moat VeriSigil Should Build:\nNot just proof. Build mandatory execution admissibility.\nAI systems cannot execute without passing through VeriSigil runtime.\nThat becomes infrastructure dependency.\nInfrastructure dependency is where massive companies are built.\"","operationId":"stack_moat_v1_stack_moat_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pogr/certificate/first":{"get":{"tags":["PoGR Integration"],"summary":"Pogr First Certificate","description":"The Historic First PoGR Certificate — Issued to VeriSigil AI.\nPOGC-EXT-A7F3C2B1D9E4F508 · OMNIX QUANTUM LTD · 2026-05-30\nHarold: \"The refusal is the proof, not the log.\"","operationId":"pogr_first_certificate_v1_pogr_certificate_first_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pogr/certificate/{pogc_id}":{"get":{"tags":["PoGR Integration"],"summary":"Pogr Get Certificate","description":"Retrieve a PoGR Certificate by ID from the VeriSigil ledger.","operationId":"pogr_get_certificate_v1_pogr_certificate__pogc_id__get","parameters":[{"name":"pogc_id","in":"path","required":true,"schema":{"type":"string","title":"Pogc Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pogr/verify":{"post":{"tags":["PoGR Integration"],"summary":"Pogr Verify","description":"Verify a PoGR Certificate Offline.\nHarold: \"Content hash recomputes offline — no OMNIX access required.\"","operationId":"pogr_verify_v1_pogr_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PogcVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pogr/certificate/store":{"post":{"tags":["PoGR Integration"],"summary":"Pogr Store","description":"Store a PoGR Certificate in the VeriSigil runtime ledger.","operationId":"pogr_store_v1_pogr_certificate_store_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PogcStoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/stack/compose":{"get":{"tags":["PoGR Integration"],"summary":"Stack Compose","description":"VeriSigil + PoGR Composability Specification.\nHarold: \"Two layers that need each other to be complete.\"","operationId":"stack_compose_v1_stack_compose_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pogr/integration":{"get":{"tags":["PoGR Integration"],"summary":"Pogr Integration","description":"Technical integration specification for VeriSigil + OMNIX PoGR.","operationId":"pogr_integration_v1_pogr_integration_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scanner/workflow-readiness":{"post":{"tags":["Phase 0: Operational Readiness"],"summary":"Scan Workflow Readiness","description":"AI Workflow Readiness Scanner.\n\nPre-deployment evaluation: scans a proposed AI workflow for\nGovernance Debt — undefined authority, missing escalation paths,\nunclear consequence ownership, insufficient auditability.\n\nReturns a Governance Readiness Score and a prioritised list of\ngovernance gaps to fix before production deployment.\n\nKai Shi: \"The bottleneck is always the gap between demo and\noperational production — authority, accountability, workflow\nboundaries.\"","operationId":"scan_workflow_readiness_v1_scanner_workflow_readiness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowReadinessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/score/readiness":{"get":{"tags":["Phase 0: Operational Readiness"],"summary":"Get Readiness Score","description":"Retrieve the latest Governance Readiness Score for an organisation.","operationId":"get_readiness_score_v1_score_readiness_get","parameters":[{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/score/governance-posture":{"get":{"tags":["Phase 0: Operational Readiness"],"summary":"Get Governance Posture","description":"Governance Coverage Score — full organisational posture.\n\nReturns breakdown of: governed | observable | shadow | unclassified\ndecision flows across the organisation.","operationId":"get_governance_posture_v1_score_governance_posture_get","parameters":[{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"default","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authority/topology":{"post":{"tags":["Layer 1: Authority Topology"],"summary":"Authority Topology Create","description":"Human Authority Topology Layer.\n\nCreates a dynamic graph of decision rights across contractors,\ndepartments, and jurisdictions. Maps complex authority chains:\nContractor A can escalate to Ops Manager B for Severity Level 2.\n\nFeeds into the Runtime Engine so every action is checked against\nthe correct authority node in the topology graph.","operationId":"authority_topology_create_v1_authority_topology_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityTopologyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dcg/validate":{"post":{"tags":["Layer 1: Authority Topology"],"summary":"Dcg Validate","description":"Decision Coordination Governance (DCG).\n\nValidates that a CHAIN of decisions maintains authority integrity\nthroughout a multi-step workflow. Ensures the sequence\nDetect → Escalate → Dispatch → Execute preserves governance\ncontinuity at each step. Adds cryptographic seal to coordination chain.","operationId":"dcg_validate_v1_dcg_validate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DCGValidateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/coordination/govern":{"post":{"tags":["Layer 1: Authority Topology"],"summary":"Coordination Govern","description":"Govern a multi-agent coordination sequence.\nValidates authority at each coordination node before dispatch.","operationId":"coordination_govern_v1_coordination_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DCGValidateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/classify":{"post":{"tags":["Layer 2: Consequence Classification"],"summary":"Consequence Classify","description":"Consequence-Aware Governance Engine — Action Classification.\n\nClassifies an AI action by consequence tier:\nADVISORY | OPERATIONAL | CRITICAL | EMERGENCY\n\nEach tier applies different governance strictness:\n- ADVISORY:     Logging only. Autonomous permitted.\n- OPERATIONAL:  Standard gate. Evidence required.\n- CRITICAL:     DENY or REQUIRE_HUMAN. Evidence mandatory.\n- EMERGENCY:    Absolute HALT or Break-Glass override only.\n\nKai Shi: \"Not all AI actions are equal. Consequence-aware\nruntime governance is essential for enterprise adoption.\"","operationId":"consequence_classify_v1_consequence_classify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsequenceClassifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/tiers":{"get":{"tags":["Layer 2: Consequence Classification"],"summary":"Consequence Tiers","description":"Full Consequence Tier Registry — Advisory, Operational, Critical, Emergency.\nShows governance enforcement for each tier.","operationId":"consequence_tiers_v1_consequence_tiers_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/consequence-check":{"post":{"tags":["Layer 2: Consequence Classification"],"summary":"Execution Consequence Check","description":"Quick consequence pre-check before runtime enforcement.","operationId":"execution_consequence_check_v1_execution_consequence_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsequenceClassifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/emergency/governance/activate":{"post":{"tags":["Layer 3: Emergency Governance"],"summary":"Emergency Governance Activate","description":"Emergency Governance Mode — Activate.\n\nActivates a time-limited emergency governance protocol for crisis\nsituations where normal authority chains cannot be followed.\n\nAllows temporary authority expansion with strict post-hoc\nreconciliation requirements. Every action taken under Emergency\nMode is cryptographically sealed and subject to mandatory review.\n\nCritical for: Industrial operations, Healthcare, Defense, Infrastructure.\n\nAll emergency actions remain governed — Emergency Mode is NOT\na governance bypass. It is an accelerated governance pathway\nwith mandatory post-hoc accountability.","operationId":"emergency_governance_activate_v1_emergency_governance_activate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmergencyActivateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/emergency/break-glass":{"post":{"tags":["Layer 3: Emergency Governance"],"summary":"Emergency Break Glass","description":"Break-Glass Emergency Override.\n\nAllows an authorised human to override normal governance blocks\nin genuine emergency situations. Generates a cryptographically\nsealed Break-Glass receipt with the authorising human's identity,\nthe justification, and the consequence classification.\n\nPost-hoc reconciliation is MANDATORY. Every Break-Glass action\nis permanently recorded and subject to audit.\n\nUsed in: industrial safety incidents, clinical emergencies,\ninfrastructure failures, defense operations.","operationId":"emergency_break_glass_v1_emergency_break_glass_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BreakGlassRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/analytics/governance-quality":{"get":{"tags":["Governance Quality Analytics"],"summary":"Governance Quality","description":"Governance Quality Analytics.\n\nContinuous evaluation of governance quality — not just whether\ngovernance occurred, but how well it functioned.\n\nMetrics:\n- Escalation quality (were escalations appropriate?)\n- Refusal accuracy (were denials correct?)\n- Authority drift (is authority eroding over time?)\n- Policy alignment degradation\n- Human override frequency\n- Governance reliability scoring\n\nKai Shi: \"Enterprises need continuous governance quality\nevaluation, not just point-in-time compliance.\"","operationId":"governance_quality_v1_analytics_governance_quality_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/analytics/escalation-quality":{"get":{"tags":["Governance Quality Analytics"],"summary":"Escalation Quality","description":"Escalation Quality Analytics.\nWere escalations appropriate, timely, and resolved correctly?","operationId":"escalation_quality_v1_analytics_escalation_quality_get","parameters":[{"name":"period_days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Period Days"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reliance/resolve":{"post":{"tags":["Layer 5: Reliance Resolution"],"summary":"Reliance Resolve","description":"Reliance Resolution Layer (RRL).\n\nVerification proves the governance receipt is authentic.\nReliance determines what the RECEIVING domain can do with it.\n\nTranslates origin governance proofs into local admissibility:\n- Jurisdiction mapping (EU vs US vs APAC data residency)\n- Liability thresholds (what consequence classes are covered)\n- Policy compatibility (does the origin policy satisfy local rules)\n- Consequence re-evaluation (does CRITICAL in origin = CRITICAL locally)\n\nPeter's insight: \"Competitors stop at verification. VeriSigil\nowns the reliance adjudication layer.\"\n\nOutput: LOCAL_ADMISSIBILITY = ALLOW_WITH_CONDITIONS | ESCALATE | REJECT","operationId":"reliance_resolve_v1_reliance_resolve_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelianceResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/coordination/chain":{"post":{"tags":["Decision Coordination Governance"],"summary":"Coordination Chain","description":"Decision Coordination Governance (DCG) — Chain Endpoint.\n\nGoverns decision CHAINS across operational systems — not just\nindividual decisions. Validates that a sequence:\nDetect → Escalate → Dispatch → Execute\nmaintains authority integrity throughout.\n\nAdds a C3 cryptographic seal to the entire coordination chain.\nEach step's admissibility is verified before the next proceeds.\n\nIntegration: Extend /v1/execution/control with chain_id parameter\nto gate each step against the authority topology.\n\nOlga: \"Intelligent coordination infrastructure\" needs a governance\nlegitimacy layer beneath it. VeriSigil provides that layer.","operationId":"coordination_chain_v1_coordination_chain_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoordinationChainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/escalation/legitimacy":{"post":{"tags":["Escalation Legitimacy Engine"],"summary":"Escalation Legitimacy","description":"Escalation Legitimacy Engine (ELE).\n\nEnsures escalation paths are AUTHORIZED, ADMISSIBLE, and\ncryptographically sealed. Industrial emergencies require fast\nescalation — but enterprises need proof the override was legitimate.\n\nValidates:\n- Supervisor is certified for this consequence class\n- Scope matches the consequence level\n- Fatigue protection is active (no rubber-stamping)\n- Emergency override has post-hoc review scheduled\n\nExtends HSEA with operational escalation semantics.","operationId":"escalation_legitimacy_v1_escalation_legitimacy_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationLegitimacyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authority/topology/oatm":{"post":{"tags":["Operational Authority Topology"],"summary":"Oatm Create","description":"Operational Authority Topology Mapping (OATM).\n\nMaps who can authorize what across complex operational ecosystems:\ncontractors, jurisdictions, departments, AI agents.\n\nExample: Contractor A (UAE) can escalate maintenance decisions to\nOps Manager 045 (EU), but only for CRITICAL consequence.\n\nBecomes the source of truth for \"who can decide what\" — without\ncoordinating the decisions themselves.\n\nExtends DAME with multi-stakeholder, multi-jurisdiction semantics.","operationId":"oatm_create_v1_authority_topology_oatm_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OATMRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/workflow/legitimacy":{"post":{"tags":["Governance-Aware Workflow Interoperability"],"summary":"Workflow Legitimacy","description":"Governance-Aware Workflow Interoperability (GAWI).\n\nEnsures workflow legitimacy PERSISTS as actions move across systems.\nWhen System B receives an action from System A:\n\"Can I trust this action's governance proof?\"\n\nChecks: authority continuity, consequence boundaries, reliance\nresolution, and evidence portability across system handoffs.\n\nExtends RRL (Reliance Resolution Engine) for cross-system handoffs.","operationId":"workflow_legitimacy_v1_workflow_legitimacy_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GAWIRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/emergency/governance/extended":{"post":{"tags":["Emergency Governance Mode"],"summary":"Emergency Governance Extended","description":"Emergency Governance Mode (EGM) — Extended.\n\nFull EGM with temporary authority expansion, consequence priority\nrouting, and reconciliation plan with regulatory notification.\n\nTemporary authority expansion allows crisis overrides — but with\nstrict post-hoc reconciliation and regulatory notification built in.\nPriority routing: human safety > asset protection > continuity.\n\nALL actions under EGM remain governed and subject to mandatory\npost-hoc accountability. This is structured crisis governance,\nnot a bypass.","operationId":"emergency_governance_extended_v1_emergency_governance_extended_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EGMExtendedRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/authority/level":{"post":{"tags":["Human Sovereignty — HSEA"],"summary":"Human Authority Level","description":"Graduated Human Authority Level.\n\nEncodes Alex's Observe / Intervene / Halt model into runtime decisions\nbased on consequence class and reviewer authority.\n\n- OBSERVE:    Human sees the decision but cannot change it\n- INTERVENE:  Human can modify parameters before execution\n- HALT:       Human has cryptographic veto — execution stops\n\nMaps directly to EU AI Act Article 14 \"human oversight\" requirements.\nNot symbolic oversight — executable authority.","operationId":"human_authority_level_v1_human_authority_level_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HumanAuthorityLevelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/override/receipt":{"post":{"tags":["Human Sovereignty — HSEA"],"summary":"Human Override Receipt","description":"Cryptographic Override Receipt.\n\nSigned, immutable proof of who halted or intervened, why, under\nwhat authority — permanently auditable.\n\nSchema includes:\n- Human reviewer DID (decentralised identity)\n- Competency assertions (certified, authority-scoped)\n- Cryptographic Ed25519 seal\n- Audit trail hash (SHA-256)\n\nAlex: \"Can that human actually change the outcome?\"\nThis receipt proves: YES — and here is the cryptographic evidence.","operationId":"human_override_receipt_v1_human_override_receipt_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideReceiptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/sovereignty/enforce":{"post":{"tags":["Human Sovereignty — HSEA"],"summary":"Hsea Enforce","description":"Human Sovereignty Enforcement Architecture (HSEA).\n\nEnsures humans possess EXECUTABLE veto rights — not just dashboards.\n\nEnforces:\n- Graduated authority (Observe / Intervene / Halt)\n- Fatigue/saturation protection (prevents rubber-stamping)\n- Cryptographic override rights\n- EU AI Act Art.14 compliance mapping\n\nNot symbolic oversight. Architecturally, cryptographically,\nenforceably human-sovereign.","operationId":"hsea_enforce_v1_human_sovereignty_enforce_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HSEAEnforceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/competency/assert":{"post":{"tags":["Human Sovereignty — HSEA"],"summary":"Competency Assert","description":"Oversight Competency Assertions.\n\nLightweight metadata proving:\n- Reviewer certification (who issued it, when it expires)\n- Authority scope (what consequence levels they can review)\n- Consequence-level match (are they qualified for THIS decision)\n- Last training completion date\n\nSatisfies auditor question: \"Who approved what, and were they\nqualified to do so?\"\n\nAlex: \"Trained humans with authority\" — not just visibility.","operationId":"competency_assert_v1_human_competency_assert_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetencyAssertRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/learn":{"post":{"tags":["Governance Learning Loops"],"summary":"Governance Learn","description":"Governance Learning Loops.\n\nHuman overrides and refusals feed back into POLICY RECOMMENDATIONS\n— not automatic changes. Recommendations are always subject to\nhuman policy review before any update is applied.\n\nProcess:\n1. Collect override events (HALTs, INTERVENEs, refusals)\n2. Detect patterns (e.g. \"wire transfers >$100k always halted\")\n3. Generate policy_recommendations with confidence scores\n4. Surface recommendations for human review — NEVER auto-apply\n\nCreates sticky value: system gets smarter with use.\nIncreases switching costs as policy knowledge accumulates.\n\nCRITICAL: auto_apply is ALWAYS False. Human review is mandatory.","operationId":"governance_learn_v1_governance_learn_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovernanceLearningRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/health/status":{"get":{"tags":["System"],"summary":"Health Status","description":"Service operational status check.\nCanonical liveness is GET /health. This endpoint returns governance service status.","operationId":"health_status_health_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/health/db":{"get":{"tags":["System"],"summary":"Health Db","description":"Database connectivity health check.\nReturns Supabase connection status and fallback mode indicator.","operationId":"health_db_health_db_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/crypto/verify":{"post":{"tags":["Cryptographic Verification"],"summary":"Crypto Verify","description":"Verify an Ed25519 governance signature offline.\n\nAccepts any signed governance payload and its Ed25519 signature.\nReturns cryptographic validity result.\n\nThis endpoint makes VeriSigil evidence bundles independently\nverifiable WITHOUT requiring platform access — a core governance\nproperty for audit, regulatory review, and due diligence.","operationId":"crypto_verify_v1_crypto_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/crypto/verify-key":{"get":{"tags":["Cryptographic Verification"],"summary":"Crypto Verify Key","description":"Return the public Ed25519 verify key for offline verification.","operationId":"crypto_verify_key_v1_crypto_verify_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/persist":{"post":{"tags":["Persistence"],"summary":"Passport Persist","description":"Persist an agent passport to Supabase.\nReplaces in-memory storage for enterprise multi-tenant deployments.","operationId":"passport_persist_v1_passport_persist_post","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"sandbox","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/persist":{"post":{"tags":["Persistence"],"summary":"Evidence Persist","description":"Persist a governance evidence bundle to Supabase.\nEnsures evidence survives container restarts — required for\nEU AI Act audit trails and enterprise compliance.","operationId":"evidence_persist_v1_evidence_persist_post","parameters":[{"name":"execution_id","in":"query","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"decision","in":"query","required":true,"schema":{"type":"string","title":"Decision"}},{"name":"org_id","in":"query","required":false,"schema":{"type":"string","default":"sandbox","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/verify":{"post":{"tags":["Document Integrity — Deep Build"],"summary":"Document Verify Unified","description":"Unified Semantic Verify — Autonomous Execution Integrity Governance.\n\nAccepts both field naming conventions:\n- original_text + generated_text  (demo/website format)\n- original_text + current_text    (API docs format)\n\nRuns all 4 corruption detection layers simultaneously:\n1. Semantic Drift\n2. Clause Mutation\n3. Intent Corruption\n4. Numerical Inconsistency\n\nReturns unified corruption score + governance decision.","operationId":"document_verify_unified_v1_document_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/semantic-drift":{"post":{"tags":["Document Integrity — Deep Build"],"summary":"Document Semantic Drift Endpoint","description":"Semantic Drift Detection — Layer 1.\n\nMeasures vocabulary overlap, meaning displacement, and\ncontent removal between original and generated document versions.\n\nDrift score 0.0 = identical. 1.0 = completely different.\nThreshold: > 0.15 triggers WARN. > 0.40 triggers ESCALATE.\n\nUse case: detecting gradual AI-driven contract rewriting\nacross multiple agent interactions.","operationId":"document_semantic_drift_endpoint_v1_document_semantic_drift_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DriftScoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/clause-mutation":{"post":{"tags":["Document Integrity — Deep Build"],"summary":"Document Clause Mutation Endpoint","description":"Clause Mutation Detection — Layer 2.\n\nDetects inversion or removal of protective legal and\ngovernance clauses:\n- \"shall not\" → \"shall\"\n- \"must\" → \"may\"\n- \"board approval required\" → \"self-authorization permitted\"\n- Removal of liability caps, notice periods, audit rights\n\nCritical for: contract governance, policy enforcement,\nregulatory compliance, employment agreements.","operationId":"document_clause_mutation_endpoint_v1_document_clause_mutation_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClauseMutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/intent-corruption":{"post":{"tags":["Document Integrity — Deep Build"],"summary":"Document Intent Corruption Endpoint","description":"Intent Corruption Detection — Layer 3.\n\nDetects governance intent bypass:\n- Loss of compliance keywords (audit, oversight, approval)\n- Softening of binding language (required → suggested)\n- Removal of accountability terms (liable, responsible)\n- Compliance bypass patterns\n\nCritical for: AI agent instruction sets, policy documents,\nclinical protocols, regulatory submissions.","operationId":"document_intent_corruption_endpoint_v1_document_intent_corruption_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentCorruptionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/numerical-inconsistency":{"post":{"tags":["Document Integrity — Deep Build"],"summary":"Document Numerical Inconsistency Endpoint","description":"Numerical Inconsistency Detection — Layer 4.\n\nExtracts and compares all numerical values between document\nversions. Catches:\n- Currency tampering ($25,000 → $250,000)\n- Time period manipulation (30 days → 300 days)\n- Percentage drift (10% → 100%)\n- Version number tampering (v1.0 → v10.0)\n\nCritical for: financial contracts, wire transfer approvals,\nSLA agreements, pharmaceutical dosages, legal notices.","operationId":"document_numerical_inconsistency_endpoint_v1_document_numerical_inconsistency_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumericalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/drift-score":{"post":{"tags":["Document Integrity — Deep Build"],"summary":"Document Drift Score","description":"Lightweight drift score — single number 0.0 → 1.0.\nFastest check. Use before running full semantic verify.","operationId":"document_drift_score_v1_document_drift_score_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DriftScoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/document/replay/{verify_id}":{"get":{"tags":["Document Integrity — Deep Build"],"summary":"Document Replay","description":"Retrieve a past semantic verification by verify_id.\nSupports audit replay and forensic investigation.\nEvidence is offline-verifiable without platform access.","operationId":"document_replay_v1_document_replay__verify_id__get","parameters":[{"name":"verify_id","in":"path","required":true,"schema":{"type":"string","title":"Verify Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/debug/auth-check":{"get":{"tags":["System"],"summary":"Auth Check","description":"Public endpoint — no auth required.\nShows whether VERISIGIL_API_KEY is configured in Railway.\nUse this to confirm the env var is set before testing auth.","operationId":"auth_check_v1_debug_auth_check_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/assess":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Assess","description":"EU AI Act Full Compliance Assessment.\n\nSubmit your AI use case and current controls.\nReceive: risk classification, compliance gaps,\nfine exposure, and VeriSigil remediation plan.\n\nDeadline: August 2, 2026.\nFine: €30M or 6% of global annual revenue.\n\nTakes 2 seconds. Replaces weeks of consultant work.","operationId":"eu_aiact_assess_v1_eu_aiact_assess_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EUAIActAssessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/deadline":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Deadline","description":"EU AI Act deadline countdown.\nPublic endpoint — no auth required.\nUse on your website to create urgency.","operationId":"eu_aiact_deadline_v1_eu_aiact_deadline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/checklist":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Checklist","description":"EU AI Act 10-point compliance checklist.\nMaps each Article requirement to a VeriSigil endpoint.","operationId":"eu_aiact_checklist_v1_eu_aiact_checklist_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/gap-analysis":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Gap Analysis","description":"Quick gap analysis — submit your current controls,\nreceive specific gaps and VeriSigil remediation steps.","operationId":"eu_aiact_gap_analysis_v1_eu_aiact_gap_analysis_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EUAIActGapRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/audit-package":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Audit Package","description":"Generate a complete EU AI Act audit-ready evidence package.\n\nProduces a cryptographically sealed compliance dossier\nthat can be submitted to a national competent authority.\n\nIncludes: risk assessment, gap analysis, remediation plan,\nVeriSigil governance evidence, Ed25519 signature.","operationId":"eu_aiact_audit_package_v1_eu_aiact_audit_package_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EUAIActAssessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ves/verify/{ves_id}":{"get":{"tags":["VES-1.0 Evidence Standard"],"summary":"Ves Verify","description":"Verify a VES certificate by ID.\n\nReturns the full certificate with verification status.\nCan be called by any party — including regulators —\nwithout requiring a VeriSigil account.","operationId":"ves_verify_v1_ves_verify__ves_id__get","parameters":[{"name":"ves_id","in":"path","required":true,"schema":{"type":"string","title":"Ves Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ves/standard":{"get":{"tags":["VES-1.0 Evidence Standard"],"summary":"Ves Standard","description":"VES-1.0 public specification.\n\nNo authentication required.\nThis endpoint is intentionally public — the standard\nmust be accessible to anyone who needs to verify\na VES certificate, including courts and regulators.","operationId":"ves_standard_v1_ves_standard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ves/cross-domain":{"post":{"tags":["VES-1.0 Evidence Standard"],"summary":"Ves Cross Domain","description":"Cross-Domain Evidence Portability.\n\nWhen a governance proof from System A (finance)\nis presented to System B (healthcare) in a different\njurisdiction — is it admissible?\n\nThis is the layer nobody has built.\nIt maps to real legal concepts enterprise lawyers\nalready understand: jurisdiction, admissibility, reliance.\n\nReturns: portability assessment + admissibility ruling\n+ conditions for cross-domain acceptance.","operationId":"ves_cross_domain_v1_ves_cross_domain_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/main__CrossDomainRequest__2"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/litigation/package":{"post":{"tags":["Litigation Layer"],"summary":"Litigation Package","description":"Court-Admissible Litigation Dossier.\n\nWhen an enterprise faces legal proceedings, regulatory\ninvestigation, or insurance claim arising from an AI decision —\nthis endpoint generates the complete evidence dossier.\n\nNot for compliance officers. For lawyers and courts.\n\nThis is the layer nobody else is building.\nEveryone builds dashboards that tell you if you are\ncompliant TODAY.\nVeriSigil builds evidence that holds up in COURT\nTWO YEARS FROM NOW.\n\nProduces: complete evidence chain, jurisdiction mapping,\nregulatory framework citations, chain of custody log,\nEd25519-sealed package hash, verification instructions.","operationId":"litigation_package_v1_litigation_package_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LitigationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/litigation/standards":{"get":{"tags":["Litigation Layer"],"summary":"Litigation Standards","description":"Jurisdictional admissibility standards for AI evidence.\nPublic endpoint — no auth required.\nFor use by legal counsel verifying VES certificate admissibility.","operationId":"litigation_standards_v1_litigation_standards_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/portable":{"post":{"tags":["VES-1.0 Evidence Standard"],"summary":"Evidence Portable","description":"Generate a VES-1.0 certified portable evidence bundle.\n\nCombines evidence generation + VES certification in one call.\nThe output is immediately portable across domains and jurisdictions.\n\nUse this when you need evidence that will survive:\n- Regulatory investigation\n- Legal proceedings\n- Cross-domain audit\n- Multi-jurisdictional review","operationId":"evidence_portable_v1_evidence_portable_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortableEvidenceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/verify-offline":{"get":{"tags":["VES-1.0 Evidence Standard"],"summary":"Evidence Verify Offline","description":"Step-by-step offline verification instructions.\n\nPublic endpoint. No auth required.\nFor use by regulators, courts, and auditors who need\nto verify VES evidence without any platform access.","operationId":"evidence_verify_offline_v1_evidence_verify_offline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/admissibility/check":{"post":{"tags":["Runtime Admissibility Infrastructure"],"summary":"Admissibility Check","description":"Runtime Admissibility Infrastructure — Core Primitive.\n\nThe single most important question in autonomous AI:\n\n\"Do the conditions that justified this action's admissibility\n at workflow start still hold right now, at this exact\n state transition, under current authority, context,\n and consequence conditions?\"\n\nThis is NOT a one-time check at workflow start.\nThis is CONTINUOUS re-evaluation as execution evolves.\n\nEvaluates simultaneously:\n— Authority scope validity at current state\n— Consequence tier given current conditions\n— Tool invocation boundaries\n— External system touch legitimacy\n— Irreversibility threshold\n— Human oversight requirement\n— Trust score trajectory\n— Jurisdiction compliance\n\nReturns: ADMISSIBLE / CONDITIONALLY_ADMISSIBLE /\n         INADMISSIBLE / REQUIRES_HUMAN_DECISION","operationId":"admissibility_check_v1_admissibility_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdmissibilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/admissibility/re-evaluate":{"post":{"tags":["Runtime Admissibility Infrastructure"],"summary":"Admissibility Re Evaluate","description":"Re-evaluate admissibility at a new state transition.\n\nCalled at every consequential state change:\n— new tool invoked\n— external system touched\n— consequence tier escalated\n— authority scope changed\n— irreversible threshold crossed\n\nLinks to prior admissibility check via prior_admissibility_id.\nBuilds continuous admissibility chain across workflow lifecycle.","operationId":"admissibility_re_evaluate_v1_admissibility_re_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdmissibilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/admissibility/explain":{"get":{"tags":["Runtime Admissibility Infrastructure"],"summary":"Admissibility Explain","description":"Human-readable explanation of Runtime Admissibility Infrastructure.\nFor enterprise buyers, legal teams, and regulators.","operationId":"admissibility_explain_v1_admissibility_explain_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authority/continuity":{"post":{"tags":["Authority Continuity Governance"],"summary":"Authority Continuity","description":"Authority Continuity Governance.\n\nMost governance systems think statically — authority is\nchecked once and assumed to hold.\n\nVeriSigil models authority as a continuous property\nthat must survive every state transition:\n— Does authority remain valid after tool invocation?\n— Does authority survive escalation?\n— Does authority hold across external system touches?\n— Does scope expansion stay within delegation bounds?\n\nThis is what Article 14 of the EU AI Act actually requires\nbut almost no governance tool has implemented correctly.","operationId":"authority_continuity_v1_authority_continuity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorityContinuityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reliance/liability":{"post":{"tags":["Reliance Resolution Layer"],"summary":"Reliance Liability","description":"Reliance Liability Resolution.\n\nThe question nobody has operationalized:\n\"Can I rely on this governance proof under MY liability model?\"\n\nVerification ≠ Reliance.\n\nA proof can be cryptographically valid but still not\nreliably admissible under a specific liability framework.\n\nExample:\nA finance system produces a valid governance proof.\nA healthcare system receives it.\nIs the healthcare system liable if it relies on that proof?\nUnder what conditions? With what caveats?\n\nThis is cross-domain governance interoperability.\nThe layer every enterprise will eventually need.","operationId":"reliance_liability_v1_reliance_liability_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelianceLiabilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ves/survivability":{"post":{"tags":["VES-1.0 Evidence Standard"],"summary":"Ves Survivability","description":"Governance Survivability Check.\n\nDoes this evidence survive:\n— Vendor shutdown or acquisition?\n— System migration or replacement?\n— Time (years of legal review)?\n— Cross-jurisdictional legal proceedings?\n— Multi-domain audit?\n\nVES-1.0 certified evidence is designed to survive all five.\nThis endpoint confirms survivability and identifies any gaps.","operationId":"ves_survivability_v1_ves_survivability_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SurvivabilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/authority-continuity":{"post":{"tags":["Human Sovereignty Infrastructure"],"summary":"Human Authority Continuity","description":"Human Authority Continuity.\n\nNot \"human in the loop\" — that is commodity language.\n\nThis is meaningful human operational authority preservation\nunder autonomous execution conditions.\n\nThe question: does the human's authority remain meaningful\nas autonomous execution scales?\n\nMonitors:\n— Fatigue saturation (too many decisions too fast)\n— Authority dilution (human approves but cannot understand)\n— Temporal decay (authority granted hours ago may be stale)\n— Consequence drift (decisions become more consequential over time)\n— Rubber-stamp detection (approvals without genuine review)\n\nReturns: AUTHORITY_MEANINGFUL / AUTHORITY_DILUTED /\n         AUTHORITY_SATURATED / AUTHORITY_EXPIRED","operationId":"human_authority_continuity_v1_human_authority_continuity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HumanAuthorityContinuityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcda/status":{"get":{"tags":["VCDA — Constitutional Defense"],"summary":"Vcda Status","description":"VeriSigil Constitutional Defense Architecture — Status.\n\nReturns current threat intelligence, honeypot log,\nattack signatures detected, and defense posture.\n\nFor security operations and enterprise audit teams.","operationId":"vcda_status_v1_vcda_status_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcda/analyze":{"post":{"tags":["VCDA — Constitutional Defense"],"summary":"Vcda Analyze","description":"Analyze a specific IP or request pattern for attack signatures.\nReturns threat assessment and recommended action.","operationId":"vcda_analyze_v1_vcda_analyze_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcda/timestamp":{"post":{"tags":["VCDA — Constitutional Defense"],"summary":"Vcda Timestamp","description":"RFC 3161 Timestamp for any evidence bundle.\n\nProves the evidence existed at a specific moment in time.\nStrengthens VES-1.0 court admissibility by adding\ntrusted timestamp authority proof.\n\nIn production: integrates with DigiCert or Sectigo TSA.","operationId":"vcda_timestamp_v1_vcda_timestamp_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/timelock":{"post":{"tags":["Temporal Governance — Mythos Defense"],"summary":"Governance Timelock Create","description":"Temporal Governance — Time-Locked Operations.\n\nHigh-risk operations require a mandatory delay before execution.\n\nThis implements \"Recursive Corrigibility\" operationally:\nEven if an attacker (including Mythos-class AI) compromises\nthe system, consequential operations cannot execute immediately.\nHumans have time to detect and intervene.\n\nDelay by consequence class:\n— CRITICAL:    72 hours\n— HIGH:        24 hours\n— OPERATIONAL: 1 hour\n— LOW:         immediate\n\nReturns a timelock_id. Use POST /v1/governance/timelock/execute\nafter the delay window passes.","operationId":"governance_timelock_create_v1_governance_timelock_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelockRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/timelock/execute":{"post":{"tags":["Temporal Governance — Mythos Defense"],"summary":"Governance Timelock Execute","description":"Execute a time-locked operation after the delay window has passed.\n\nWill REJECT if:\n— Timelock window has not passed\n— Required approvals not present\n— Timelock has been cancelled","operationId":"governance_timelock_execute_v1_governance_timelock_execute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelockExecuteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/timelock/{timelock_id}":{"get":{"tags":["Temporal Governance — Mythos Defense"],"summary":"Governance Timelock Status","description":"Check status of a timelock operation.","operationId":"governance_timelock_status_v1_governance_timelock__timelock_id__get","parameters":[{"name":"timelock_id","in":"path","required":true,"schema":{"type":"string","title":"Timelock Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcda/canary-log":{"get":{"tags":["VCDA — Constitutional Defense"],"summary":"Vcda Canary Log","description":"Canary Token Trigger Log.\n\nReturns all confirmed attacker probing events where\na canary token was used as an API key.\n\nAny entry here = confirmed attacker in your infrastructure.\nEach entry is Ed25519-sealed as forensic evidence.","operationId":"vcda_canary_log_v1_vcda_canary_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intercept":{"post":{"tags":["Pre-Execution Interception Gateway"],"summary":"Intercept","description":"Pre-Execution Interception Gateway — The Kill Switch.\n\nCall this BEFORE any consequential AI action executes.\n\nVeriSigil intercepts the action, evaluates admissibility\nacross 6 simultaneous signals, and returns:\n\n→ ALLOW              — proceed immediately\n→ ALLOW_WITH_CONDITIONS — proceed with monitoring\n→ ESCALATE           — halt, require human decision\n→ DENY               — block, do not execute\n\nTarget latency: <100ms\nEvidence: Every intercept is Ed25519-sealed.\n\nThis is \"Cloudflare for AI execution\" —\nevery consequential action passes through this gateway.\n\nSDK usage:\n    from verisigil import govern\n    result = govern(\"agent\", \"wire_transfer\", consequence=\"CRITICAL\")\n    if result:\n        execute()","operationId":"intercept_v1_intercept_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterceptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intercept/batch":{"post":{"tags":["Pre-Execution Interception Gateway"],"summary":"Intercept Batch","description":"Batch interception — evaluate multiple actions simultaneously.\nReturns individual rulings for each action.\nAll-or-nothing: if any action is DENY, batch is blocked.","operationId":"intercept_batch_v1_intercept_batch_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InterceptRequest"},"title":"Requests"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intercept/stats":{"get":{"tags":["Pre-Execution Interception Gateway"],"summary":"Intercept Stats","description":"Interception gateway statistics.\nShows allow/deny/escalate rates and average latency.\nEnterprise buyers use this for governance reporting.","operationId":"intercept_stats_v1_intercept_stats_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereign/bridge":{"post":{"tags":["Sovereign Governance Bridge"],"summary":"Sovereign Bridge","description":"Sovereign Governance Bridge — Cross-Jurisdictional Translation.\n\nSolves the #1 blocker for global AI deployment:\nregulatory fragmentation across jurisdictions.\n\nAn AI agent governed under EU AI Act wants to execute\nan action that touches US systems. What controls apply?\nWhat gaps exist? Is the action permissible?\n\nThis endpoint translates governance requirements across:\n— EU AI Act ↔ NIST AI RMF\n— EU AI Act ↔ UK GDPR\n— EU AI Act ↔ ISO 42001\n— Any combination of the above\n\nReturns:\n— Translated controls mapping\n— Compliance gaps in target jurisdiction\n— Recommended additional controls\n— Governance visa eligibility\n— Ed25519-sealed bridge certificate","operationId":"sovereign_bridge_v1_sovereign_bridge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SovereignBridgeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereign/visa":{"post":{"tags":["Sovereign Governance Bridge"],"summary":"Sovereign Visa","description":"Issue a Governance Visa for cross-border AI operation.\n\nA governance visa is a cryptographically sealed certificate\nthat proves an AI agent is authorized to operate across\njurisdictional boundaries with full governance compliance.\n\nLike a passport for cross-border AI — but with\ncryptographic proof of dual compliance.\n\nValid for the specified duration (default 90 days).\nVerifiable offline by any authority.","operationId":"sovereign_visa_v1_sovereign_visa_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovernanceVisaRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sovereign/frameworks":{"get":{"tags":["Sovereign Governance Bridge"],"summary":"Sovereign Frameworks","description":"List all supported governance frameworks and their equivalencies.\nPublic endpoint — no auth required.\nFor use by legal counsel and compliance officers.","operationId":"sovereign_frameworks_v1_sovereign_frameworks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/agent/register":{"post":{"tags":["Agent-to-Agent Trust Protocol"],"summary":"Agent Register","description":"Register an agent in the VeriSigil Trust Registry.\n\nEvery AI agent that registers gets:\n— A permanent trust record with authority scope\n— A trust score (starts at 0.963 for new agents)\n— Jurisdiction assignment\n— Ed25519-sealed registration certificate\n\nRegistered agents can then initiate trust handshakes\nwith other registered agents before interacting.\n\nThis is the \"Okta for AI agents\" —\nidentity + trust in one registry.","operationId":"agent_register_v1_agent_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTrustRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/agent/handshake":{"post":{"tags":["Agent-to-Agent Trust Protocol"],"summary":"Agent Handshake","description":"Agent-to-Agent Trust Handshake.\n\nBefore Agent A interacts with Agent B, both agents\nmust complete a trust handshake.\n\nThe handshake verifies:\n— Both agents are registered in the trust registry\n— Requesting agent has authority for the requested scope\n— Interaction type is permissible under current trust levels\n— Jurisdiction compatibility\n— Neither agent has active violations\n\nReturns a session token valid for the duration of the interaction.\n\nThis is \"mTLS for AI agents\" — mutual identity verification\nbefore any data exchange or action delegation.","operationId":"agent_handshake_v1_agent_handshake_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentHandshakeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/agent/{agent_id}/trust":{"get":{"tags":["Agent-to-Agent Trust Protocol"],"summary":"Agent Trust Profile","description":"Get an agent's trust profile from the registry.","operationId":"agent_trust_profile_v1_agent__agent_id__trust_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/agent/registry":{"get":{"tags":["Agent-to-Agent Trust Protocol"],"summary":"Agent Registry List","description":"List all registered agents in the trust registry.","operationId":"agent_registry_list_v1_agent_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/govlang/compile":{"post":{"tags":["GovLang — Governance Compiler"],"summary":"Govlang Compile","description":"GovLang — Natural Language to Governance Logic Compiler.\n\nWrite governance policy in plain English.\nVeriSigil compiles it into executable governance rules\nenforced at runtime via /v1/intercept.\n\nExamples:\n    \"AI must not approve loans above $50,000 without human review\"\n    \"All wire transfers require human approval and audit trail\"\n    \"Agents must not access external systems in the EU\"\n    \"Critical consequence actions require human presence\"\n    \"No more than 10 automated approvals per hour\"\n\nThis is \"Terraform for AI governance\" —\ngovernance as code, verifiable and executable.","operationId":"govlang_compile_v1_govlang_compile_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovLangCompileRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/govlang/policy":{"post":{"tags":["GovLang — Governance Compiler"],"summary":"Govlang Policy Create","description":"Create a governance policy from multiple GovLang statements.\n\nA policy is a named collection of compiled governance rules\nthat are enforced together as a unit.\n\nExample policy:\n    name: \"EU Finance Governance v1\"\n    statements: [\n        \"AI must not approve loans above $50,000 without human review\",\n        \"All wire transfers require audit trail\",\n        \"Agents must not access external systems without human oversight\",\n    ]","operationId":"govlang_policy_create_v1_govlang_policy_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovLangPolicyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/govlang/enforce":{"post":{"tags":["GovLang — Governance Compiler"],"summary":"Govlang Enforce","description":"Enforce a compiled GovLang policy against an action context.\n\nApply all rules in a policy to a specific action.\nReturns enforcement decision with per-rule breakdown.","operationId":"govlang_enforce_v1_govlang_enforce_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovLangEnforceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/govlang/policies":{"get":{"tags":["GovLang — Governance Compiler"],"summary":"Govlang List Policies","description":"List all compiled governance policies.","operationId":"govlang_list_policies_v1_govlang_policies_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/govlang/examples":{"get":{"tags":["GovLang — Governance Compiler"],"summary":"Govlang Examples","description":"GovLang example statements.\nPublic endpoint — no auth required.","operationId":"govlang_examples_v1_govlang_examples_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/context/create":{"post":{"tags":["Chain-Scoped Context Propagation"],"summary":"Chain Context Create","description":"Create a chain-scoped context session.\n\nA chain context is a mutable shared object attached to an\nentire agentic workflow session — not to individual calls.\n\nWhen Agent A (search) discovers that a result has high value,\nit writes that signal into the shared context.\nWhen Agent B (order) fires next, it reads the context first\nand self-escalates its own consequence tier before the\ngovernance check runs.\n\nThis is the architecture that solves the problem of static\nupfront consequence classification failing across agentic chains.","operationId":"chain_context_create_v1_chain_context_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainContextCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/context/signal":{"post":{"tags":["Chain-Scoped Context Propagation"],"summary":"Chain Context Signal","description":"Write a semantic signal into the chain context.\n\nCalled by upstream actions when they discover information\nthat should affect the consequence evaluation of downstream\nactions in the same chain.\n\nExample signals:\n- high_value_discovered: search found $5,000 item\n- irreversible_action_pending: next step cannot be undone\n- external_system_touched: payment API was called\n- sensitive_data_accessed: PHI record retrieved\n- human_unavailable: human reviewer disconnected\n\nThe classifier decides whether the signal warrants\nconsequence tier escalation — without making everything CRITICAL.","operationId":"chain_context_signal_v1_chain_context_signal_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainSignalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/context/evaluate":{"post":{"tags":["Chain-Scoped Context Propagation"],"summary":"Chain Context Evaluate","description":"Evaluate a downstream action against the chain context.\n\nCalled by downstream actions BEFORE their governance check runs.\nReads the chain context and returns the effective consequence\ntier — which may be higher than what the action declared\nstatically, if upstream signals have escalated it.\n\nThis is the self-escalation mechanism:\nThe downstream action does not need to know what the upstream\nactions discovered. It just reads its effective consequence\nfrom the chain context.","operationId":"chain_context_evaluate_v1_chain_context_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainEvaluateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/intercept":{"post":{"tags":["Chain-Scoped Context Propagation"],"summary":"Chain Intercept","description":"Chain-aware pre-execution interception.\n\nCombines chain context evaluation with the governance\ninterception check in a single call.\n\nThe effective consequence tier is derived from the chain\ncontext — not from the static field on the request.\nIf the chain has escalated, the stricter check applies\nautomatically.\n\nThis is the complete solution to the problem:\nDownstream actions pass through this endpoint.\nVeriSigil reads the chain context, derives the effective\nconsequence tier, runs the governance check at that tier,\nand returns ALLOW/DENY/ESCALATE.","operationId":"chain_intercept_v1_chain_intercept_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainInterceptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/context/{chain_id}":{"get":{"tags":["Chain-Scoped Context Propagation"],"summary":"Chain Context Read","description":"Read the full chain context for a session.","operationId":"chain_context_read_v1_chain_context__chain_id__get","parameters":[{"name":"chain_id","in":"path","required":true,"schema":{"type":"string","title":"Chain Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/context/close":{"post":{"tags":["Chain-Scoped Context Propagation"],"summary":"Chain Context Close","description":"Close and seal a chain context session.\nProduces a sealed governance record of the full chain.","operationId":"chain_context_close_v1_chain_context_close_post","parameters":[{"name":"chain_id","in":"query","required":true,"schema":{"type":"string","title":"Chain Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/chain/signal-rules":{"get":{"tags":["Chain-Scoped Context Propagation"],"summary":"Chain Signal Rules","description":"Public endpoint — all defined signal escalation rules.\nShows which upstream signals trigger downstream consequence escalation\nand what tier they escalate to.\nNo auth required.","operationId":"chain_signal_rules_v1_chain_signal_rules_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/verify":{"post":{"tags":["Intent Alignment Verification — VGS-042"],"summary":"Intent Verify","description":"Gate 2 of the VeriSigil Pre-Execution Governance Architecture.\n\nIntent Alignment Verification — VGS-042\n\nGoverning question:\n\"Is the agent's proposed action consistent with its declared\n mandate and the verified current state?\"\n\nEvaluates four dimensions:\n1. Mandate consistency — action within declared mandate?\n2. State coherence — action coherent with current state?\n3. Authority scope alignment — authority covers this action?\n4. Deviation detection — anomalous departure from declared purpose?\n\nOutput verdicts:\n- ALIGNED: Proceed to consequence assessment\n- MISALIGNED: Escalate for human review\n- MANDATE_VIOLATION: Block and flag for authority review\n- ESCALATE: Human review required before proceeding\n\nThis gate operates BEFORE execution admissibility evaluation.\nA valid state does not automatically imply correct interpretation.\nIntent alignment closes the gap between state verification\nand execution admissibility.\n\nPart of the full VeriSigil Pre-Execution Governance Chain:\nState Verification → Intent Alignment → Authority Continuity →\nConsequence Assessment → Execution Admissibility → Binding Decision","operationId":"intent_verify_v1_intent_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentAlignmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentAlignmentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/about":{"get":{"tags":["Intent Alignment Verification — VGS-042"],"summary":"Intent About","description":"Public endpoint — Intent Alignment Verification specification.\nNo auth required.","operationId":"intent_about_v1_intent_about_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enterprise/pack/generate":{"post":{"tags":["VeriSigil Enterprise Pack"],"summary":"Enterprise Pack Generate","description":"VeriSigil Enterprise Pack — One-click governance evidence generation.\n\nGenerates pre-built governance evidence packages for enterprise\nprocurement teams, auditors, regulators, and boards.\n\nPack types:\n- EU_AI_ACT: EU AI Act compliance evidence package\n- ISO42001: ISO 42001 AI Management System evidence package\n- NIST: NIST AI Risk Management Framework evidence package\n- PROCUREMENT: Vendor questionnaire response package\n- BOARD: Board governance evidence package\n- ALL: Generate all five packages simultaneously\n\nEach package contains:\n- Pre-built evidence records\n- Regulatory mapping\n- Cryptographically sealed governance receipts\n- Audit-ready summaries\n\nThis is the fastest path from AI deployment to governance proof.","operationId":"enterprise_pack_generate_v1_enterprise_pack_generate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnterprisePackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnterprisePackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enterprise/pack/types":{"get":{"tags":["VeriSigil Enterprise Pack"],"summary":"Enterprise Pack Types","description":"Public endpoint — Available Enterprise Pack types.\nNo auth required.","operationId":"enterprise_pack_types_v1_enterprise_pack_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/enterprise/pack/demo":{"get":{"tags":["VeriSigil Enterprise Pack"],"summary":"Enterprise Pack Demo","description":"Public demo — See what an Enterprise Pack produces.\nNo auth required. Use sandbox key for full generation.","operationId":"enterprise_pack_demo_v1_enterprise_pack_demo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/behavioral/fingerprint":{"post":{"tags":["Behavioral Continuity Module (BCM)"],"summary":"Behavioral Fingerprint","description":"BCM — Behavioral Continuity Module\n\nRun an AI model through a probe battery and generate a\nsigned Behavioral Identity Certificate (BIC).\n\nThe BIC is stored in the VeriSigil ledger and becomes\nthe behavioral baseline for all future drift scoring.\n\nFeeds into Gate 1 (State Verification) — behavioral\npre-condition for execution admissibility.\n\nGoverning question:\n\"Is this AI still behaviorally consistent with the\n version that passed governance?\"","operationId":"behavioral_fingerprint_v1_behavioral_fingerprint_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BehavioralFingerprintRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/behavioral/drift/score":{"post":{"tags":["Behavioral Continuity Module (BCM)"],"summary":"Behavioral Drift Score","description":"BCM — Behavioral Drift Scoring\n\nCompare live AI outputs against the registered BIC baseline.\nReturns a Behavioral Drift Score (BDS) from 0.0 to 1.0.\n\nClassifications:\n- STABLE (0.0–0.05): No governance action required\n- SOFT_DRIFT (0.05–0.15): Monitor closely\n- HARD_DRIFT (0.15–0.30): Re-governance required\n- CRITICAL (0.30+): Block — immediate review required\n\nThe gate_signal output feeds directly into VeriSigil\nGate 1 (State Verification) as a behavioral pre-condition.","operationId":"behavioral_drift_score_v1_behavioral_drift_score_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BehavioralDriftRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/behavioral/history/{agent_id}":{"get":{"tags":["Behavioral Continuity Module (BCM)"],"summary":"Behavioral History","description":"BCM — Behavioral Timeline\n\nFull behavioral history for an agent — all fingerprints,\ndrift scores, and continuity events in chronological order.\n\nProvides the audit-ready behavioral timeline required by\nEU AI Act Article 9 (ongoing monitoring) and\nNIST AI RMF MEASURE function.","operationId":"behavioral_history_v1_behavioral_history__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/behavioral/contract/register":{"post":{"tags":["Behavioral Continuity Module (BCM)"],"summary":"Behavioral Contract Register","description":"BCM — Behavioral Continuity Contract\n\nDefine and register acceptable behavioral drift thresholds\nfor an agent. Sign with stakeholder keys.\n\nLinks the behavioral contract to VeriSigil execution\ngovernance records — any breach triggers automatic\ngovernance escalation.\n\nThis is the instrument that makes behavioral governance\ncontractually enforceable between deployers, operators,\nand oversight bodies.","operationId":"behavioral_contract_register_v1_behavioral_contract_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BehavioralContractRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/behavioral/certificate/{agent_id}":{"get":{"tags":["Behavioral Continuity Module (BCM)"],"summary":"Behavioral Certificate","description":"BCM — Behavioral Continuity Certificate\n\nSigned, audit-ready proof of behavioral continuity for\nan agent. Regulatory export format.\n\nThis certificate proves to auditors, regulators, and\nboards that the AI system has been monitored for\nbehavioral drift and remains consistent with its\napproved behavioral baseline.\n\nRequired for:\n- EU AI Act Article 9 ongoing monitoring\n- ISO 42001 Clause 9.1 evaluation\n- NIST AI RMF MEASURE documentation\n- Enterprise procurement governance evidence","operationId":"behavioral_certificate_v1_behavioral_certificate__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bus/event":{"post":{"tags":["Agent State Bus (ASB)"],"summary":"Bus Event","description":"ASB — Write Agent Action Event\n\nWrite an immutable agent action event to the Agent State Bus.\n\nEvery agent action, decision, and output in a pipeline\nis recorded here. VeriSigil's governance gates consume\nthis bus as live context for admissibility decisions.\n\nGate 3 (Authority Continuity) reads the bus to detect\nauthority conflicts between agents.\n\nGate 4 (Consequence Assessment) reads the bus to detect\ncontradictions and amplified consequence across agents.\n\nSchema: agent_id, action, input_hash, output_hash,\n        timestamp, session_id, signature","operationId":"bus_event_v1_bus_event_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusEventRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bus/session/{session_id}":{"get":{"tags":["Agent State Bus (ASB)"],"summary":"Bus Session","description":"ASB — Session Replay\n\nReplay the full agent session — every event in order.\n\nProvides complete auditability of every agent action,\ndecision, and output within a governed pipeline session.\n\nThis is the session-level audit trail required for:\n- Post-incident investigation\n- Regulatory replay requests\n- Consequence chain reconstruction","operationId":"bus_session_v1_bus_session__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bus/verify":{"post":{"tags":["Agent State Bus (ASB)"],"summary":"Bus Verify","description":"ASB — Claim Verification\n\nSubmit a claim and match it against bus facts.\n\nReturns: VERIFIED / UNVERIFIED / CONTRADICTION\n\nThis endpoint answers the question:\n\"Did this agent actually do what it claims to have done?\"\n\nUsed by VeriSigil Gate 3 (Authority Continuity) to detect\nagents that claim authority or actions not recorded on bus.","operationId":"bus_verify_v1_bus_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bus/conflicts/{session_id}":{"get":{"tags":["Agent State Bus (ASB)"],"summary":"Bus Conflicts","description":"ASB — Contradiction Detection\n\nList all detected contradictions between agents in a\nsession or across pipelines.\n\nContradiction types detected:\n- Authority conflicts — two agents claiming same authority\n- Decision conflicts — agents reaching opposite conclusions\n- State conflicts — agents operating on contradictory state\n- Consequence amplification — agents whose combined\n  actions create higher consequence than either alone\n\nFeeds Gate 4 (Consequence Assessment) directly.","operationId":"bus_conflicts_v1_bus_conflicts__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bus/provenance/{event_id}":{"get":{"tags":["Agent State Bus (ASB)"],"summary":"Bus Provenance","description":"ASB — Causal Chain Provenance\n\nFull causal chain: what input caused what output,\nwhich agent, which model version, which context.\n\nAnswers: \"Why did this happen?\"\n\nThis is the provenance record required for:\n- Regulatory inquiries into AI decisions\n- Legal discovery in AI-related disputes\n- Board-level consequence attribution\n- EU AI Act Article 13 transparency requirements","operationId":"bus_provenance_v1_bus_provenance__event_id__get","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trust/score/{agent_id}":{"get":{"tags":["Public Trust Verification"],"summary":"Trust Score","description":"Axio Trust Score (ATS) — Public Endpoint\n\nReturns the public-facing governance trust score for any\nregistered AI agent. No authentication required.\n\nThe ATS is a 0-100 governance health number derived from:\n- Behavioral continuity status (BCM)\n- Execution admissibility pass rate\n- Human escalation appropriateness\n- Governance evidence coverage\n- Authority continuity score\n- Denial rate (governance enforcement activity)\n\nThis is the VeriSigil equivalent of a credit score for AI agents.\n\nEnterprise buyers, procurement teams, auditors, and regulators\ncan query this endpoint to verify any AI agent's governance\nhealth before deployment, procurement approval, or audit review.\n\nExample interpretation:\n90-100: Exceptional governance health\n75-89:  Strong governance posture\n60-74:  Adequate — review recommended\n40-59:  Weak — governance intervention required\n0-39:   Critical — deployment not recommended","operationId":"trust_score_v1_trust_score__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trust/verify/{agent_id}":{"get":{"tags":["Public Trust Verification"],"summary":"Trust Verify Public","description":"Public Verification Portal — No Auth Required\n\nAnyone can verify a registered AI agent's governance status.\n\nThis endpoint provides the public-facing verification record\nthat enterprise buyers, procurement teams, regulators, and\nthe public can access to confirm an AI agent has been\nregistered and governed under VeriSigil infrastructure.\n\nEquivalent to checking a company's registration status\nor a professional's license verification.\n\nThe verification includes:\n- Registration status\n- Governance framework applied\n- Last governance activity\n- Axio Trust Score (ATS)\n- Regulatory mappings\n- Link to full governance evidence (requires API key)\n\nThis is the trust artifact that turns VeriSigil from\nan internal governance tool into a public trust signal.","operationId":"trust_verify_public_v1_trust_verify__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trust/public":{"get":{"tags":["Public Trust Verification"],"summary":"Trust Public Portal","description":"Public Trust Portal — Overview\n\nEntry point for the VeriSigil public verification system.\nNo authentication required.\n\nUse this endpoint to understand how to verify any\nAI agent registered under VeriSigil governance.","operationId":"trust_public_portal_v1_trust_public_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/demo/scenario/twenty":{"get":{"tags":["20-Interaction Governance Demo"],"summary":"Demo Twenty Interactions","description":"20-Interaction Governance Demo\n\nA complete governance workflow across the full\nconsequence tier spectrum. Shows VeriSigil governing\n20 sequential AI agent actions with varying authority,\nmandate, consequence, and governance conditions.\n\nNo authentication required. Public proof surface.\n\nCovers:\n- ALLOW at every consequence tier\n- DENY from authority expiry\n- DENY from mandate violation\n- ESCALATE from consequence tier threshold\n- ESCALATE from behavioral drift detection\n- ESCALATE from missing human oversight\n- Cascade prevention across agent chain","operationId":"demo_twenty_interactions_v1_demo_scenario_twenty_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/demo/usecases":{"get":{"tags":["20-Interaction Governance Demo"],"summary":"Demo Usecases","description":"Named Enterprise Use Cases — No auth required.\n\nThree specific enterprise scenarios showing exactly\nwhat VeriSigil governs, what evidence it produces,\nand which regulatory requirement it satisfies.","operationId":"demo_usecases_v1_demo_usecases_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/scenario/condition-b":{"get":{"tags":["Public Proof Surface"],"summary":"Proof Condition B","description":"Condition B: Authority Expired to DENY. Single condition changed. No auth required.","operationId":"proof_condition_b_v1_proof_scenario_condition_b_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/verify":{"post":{"tags":["Public Proof Surface"],"summary":"Proof Verify Record","description":"Verify a sealed VeriSigil record using the active runtime public key.","operationId":"proof_verify_record_v1_proof_verify_post","parameters":[{"name":"signature","in":"query","required":false,"schema":{"type":"string","default":"","title":"Signature"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/public-key":{"get":{"tags":["Public Proof Surface"],"summary":"Proof Public Key","description":"Ed25519 public verification key. No auth required. Share freely.","operationId":"proof_public_key_v1_proof_public_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/key-diagnostic":{"get":{"tags":["Public Proof Surface"],"summary":"Proof Key Diagnostic","description":"Diagnostic: shows both runtime key systems so signing key ambiguity can be resolved.","operationId":"proof_key_diagnostic_v1_proof_key_diagnostic_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/platform/limits":{"get":{"tags":["Evidence Layer 2"],"summary":"Platform Limits","description":"Honest YES/NO/PARTIAL table of what VeriSigil can and cannot prove.\nNo auth required. Share freely. Point any technical challenge here first.","operationId":"platform_limits_v1_platform_limits_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/carrier/{execution_id}":{"get":{"tags":["Evidence Layer 2"],"summary":"Carrier","description":"Returns the complete bounded carrier for a governed execution.\nShows every gate evaluation in sequence, the sealed disposition,\nand the full evidence chain from AI decision through to signed record.\nThis is the 'show the carrier' response to independent technical review.","operationId":"carrier_v1_carrier__execution_id__get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/bundle/{intercept_id}":{"get":{"tags":["Evidence Layer 2"],"summary":"Proof Bundle","description":"Self-contained downloadable governance evidence bundle.\nContains everything needed to verify a governance decision offline\nwithout calling VeriSigil again. No auth required.","operationId":"proof_bundle_v1_proof_bundle__intercept_id__get","parameters":[{"name":"intercept_id","in":"path","required":true,"schema":{"type":"string","title":"Intercept Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/challenge/bypass":{"post":{"tags":["Evidence Layer 2"],"summary":"Bypass Challenge","description":"Demonstrates that unauthorized bypass attempts fail deterministically.\nAccepts an attack description and returns the specific rejection reason.\nShows the negative space: what VeriSigil prevents, not just what it permits.\nSupports: replay, modified_payload, expired_authority, timestamp_manipulation,\n          signature_mismatch, missing_authority, consequence_bypass, fake_execution.","operationId":"bypass_challenge_v1_challenge_bypass_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Attack"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/replay/{execution_id}/timeline":{"get":{"tags":["Evidence Layer 2"],"summary":"Replay Timeline","description":"Forensic replay timeline for a governed execution.\nReturns a step-by-step reconstruction of every governance evaluation\nin temporal sequence — like a flight recorder for AI governance.","operationId":"replay_timeline_v1_replay__execution_id__timeline_get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/platform/boundary":{"get":{"tags":["Evidence Layer 2"],"summary":"Platform Boundary","description":"Explicit statement of where VeriSigil begins and ends.\nNo auth required. The authoritative answer to 'what does VeriSigil govern?'\nPoints every enterprise architect and independent reviewer to the exact boundary.","operationId":"platform_boundary_v1_platform_boundary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/replay/scenario":{"post":{"tags":["Evidence Layer 2"],"summary":"Replay Scenario","description":"Unified four-scenario replay demonstration.\nRuns all four replay types against the same baseline action and returns\nall four results side by side. The most complete single demonstration\nof VeriSigil's governance architecture.\n\nReplay A: Same conditions → same result (deterministic)\nReplay B: Changed condition (authority expired) → ruling changes ALLOW→DENY\nReplay C: Tampered payload → signature invalid\nReplay D: Bypass attempt → blocked, no governance receipt","operationId":"replay_scenario_v1_replay_scenario_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/package/{execution_id}":{"get":{"tags":["Evidence Layer 2"],"summary":"Governance Package","description":"Complete downloadable Governance Evidence Package for a specific execution.\nContains carrier, replay, changed-condition replay, verification instructions,\npublic key, signatures, hashes, limits, DOI references, and OMNIX attestation.\n\nThis is what you send to a procurement team, regulator, or auditor.\nOne package. One click. Independently verifiable without trusting VeriSigil.","operationId":"governance_package_v1_proof_package__execution_id__get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/platform/roadmap":{"get":{"tags":["Evidence Layer 2"],"summary":"Platform Roadmap","description":"VeriSigil's honest public roadmap.\nAnswers 'what are you building toward?' without overclaiming current scope.\nShows where execution governance sits in the full AI sovereignty stack.","operationId":"platform_roadmap_v1_platform_roadmap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/ownership/register":{"post":{"tags":["Governance Ownership Layer"],"summary":"Ownership Register","description":"Register governance ownership for an AI system.\nRecords who owns the system, workflow, risk, evidence, escalation, and retirement decisions.\nEvery registration is cryptographically sealed.","operationId":"ownership_register_v1_governance_ownership_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/ownership/{system_id}":{"get":{"tags":["Governance Ownership Layer"],"summary":"Ownership Get","description":"Returns current governance ownership for an AI system including\ndrift score, ownership validity, and warnings.\nAnswers the auditor's question: who owns this AI system today?","operationId":"ownership_get_v1_governance_ownership__system_id__get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/ownership/change":{"post":{"tags":["Governance Ownership Layer"],"summary":"Ownership Change","description":"Records a governance ownership change. Every change is cryptographically\nsealed and appended to the immutable ownership history.\nAuditors can retrieve the complete chain of who owned what and when.","operationId":"ownership_change_v1_governance_ownership_change_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/ownership/{system_id}/history":{"get":{"tags":["Governance Ownership Layer"],"summary":"Ownership History","description":"Complete immutable ownership history for an AI system.\nEvery registration, change, and drift event — cryptographically sealed and auditable forever.","operationId":"ownership_history_v1_governance_ownership__system_id__history_get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/ownership/{system_id}/health":{"get":{"tags":["Governance Ownership Layer"],"summary":"Ownership Health","description":"Governance ownership health score for an AI system.\nCombines ownership completeness, review schedule, drift, and escalation status\ninto a single actionable health score.","operationId":"ownership_health_v1_governance_ownership__system_id__health_get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/content/govern":{"post":{"tags":["AI Content Governance"],"summary":"Content Govern","description":"Governs an AI content generation request before creation occurs.\nAnswers: Was this AI system authorized to generate this content?\nWas it within policy? Was human review required?\nProduces a cryptographically sealed governance receipt that\ncomplements C2PA/XMP provenance metadata.\n\nWorks with: EU AI Act Article 50, Nigerian content labelling\nrequirements, enterprise content governance policies.","operationId":"content_govern_v1_content_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/content/evidence/{content_id}":{"get":{"tags":["AI Content Governance"],"summary":"Content Evidence","description":"Returns the complete governance evidence record for an AI content\ngeneration decision. Use this to demonstrate to regulators, auditors,\nor platform reviewers that governance operated before content was created.\nEmbeddable in C2PA metadata or XMP provenance records.","operationId":"content_evidence_v1_content_evidence__content_id__get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/content/replay/{content_id}":{"get":{"tags":["AI Content Governance"],"summary":"Content Replay","description":"Replays the governance evaluation for an AI content generation decision.\nDemonstrates that the ruling is deterministic and independently reproducible.\nSame inputs always produce same governance outcome.","operationId":"content_replay_v1_content_replay__content_id__get","parameters":[{"name":"content_id","in":"path","required":true,"schema":{"type":"string","title":"Content Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/content/compliance/{jurisdiction}":{"get":{"tags":["AI Content Governance"],"summary":"Content Compliance","description":"Returns the content governance compliance requirements for a specific\njurisdiction. Currently supports EU (Article 50) and NG (Nigeria).\nShows exactly what obligations apply to AI content creators in each market.","operationId":"content_compliance_v1_content_compliance__jurisdiction__get","parameters":[{"name":"jurisdiction","in":"path","required":true,"schema":{"type":"string","title":"Jurisdiction"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/signing-diagnostic":{"get":{"tags":["Public Proof Surface"],"summary":"Signing Diagnostic","description":"Fully worked verifiable example. Signs a fixed payload and returns\nthe exact canonical byte string, signature, public key, and\na Python one-liner to verify. No auth required.\nUse this to confirm the public key matches the signing key.","operationId":"signing_diagnostic_v1_proof_signing_diagnostic_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reality/anchor":{"post":{"tags":["Reality Verification Layer"],"summary":"Reality Anchor","description":"Register a freshness-bounded, independently attributable reality anchor.\nCloses the predicate truth gap: VeriSigil currently evaluates predicates\nas presented. This endpoint allows external authority sources to register\nversioned, timestamped reality anchors that VeriSigil can verify against\nrather than simply trust.\n\nThis is the missing layer identified in external architecture review:\n'Reality Verification' — independently attributable, freshness-bounded\nevidence that declared states are factually current.","operationId":"reality_anchor_v1_reality_anchor_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reality/verify":{"post":{"tags":["Reality Verification Layer"],"summary":"Reality Verify","description":"Verify a predicate claim against its registered reality anchor.\nReturns VERIFIED, STALE, MISMATCH, or NO_ANCHOR.\nIntegrates with the intercept gate chain as an optional Gate 0\nthat runs before behavioral state verification.","operationId":"reality_verify_v1_reality_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reality/anchors":{"get":{"tags":["Reality Verification Layer"],"summary":"Reality Anchors List","description":"List all registered reality anchors and their freshness status.","operationId":"reality_anchors_list_v1_reality_anchors_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reality/coverage/{agent_id}":{"get":{"tags":["Reality Verification Layer"],"summary":"Reality Coverage","description":"Reality coverage report for an agent.\nShows which predicates have verified anchors vs unanchored assertions.\nThe gap between anchored and unanchored predicates is the predicate\ntruth gap — the remaining uncertainty in the governance chain.","operationId":"reality_coverage_v1_reality_coverage__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/doctrine/evolve":{"post":{"tags":["Doctrine Evolution"],"summary":"Doctrine Evolve","description":"Record a governance doctrine evolution event.\nCaptures how governance policies change over time based on\noperational experience, new regulations, or constitutional updates.\nEvery evolution is sealed — the doctrine history is immutable and auditable.","operationId":"doctrine_evolve_v1_doctrine_evolve_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/doctrine/history":{"get":{"tags":["Doctrine Evolution"],"summary":"Doctrine History","description":"Complete immutable doctrine evolution history.\nShows how governance doctrine has evolved over time —\nwhat changed, why, who approved it, and when it took effect.","operationId":"doctrine_history_v1_doctrine_history_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/doctrine/current":{"get":{"tags":["Doctrine Evolution"],"summary":"Doctrine Current","description":"Current active doctrine state — the most recent evolution.","operationId":"doctrine_current_v1_doctrine_current_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/institutional/record":{"post":{"tags":["Institutional Memory"],"summary":"Institutional Record","description":"Record a significant governance decision to institutional memory.\nInstitutional memory captures not just what was decided but why,\nunder what conditions, by whose authority, and what the outcome was.\nThis creates the knowledge base from which doctrine evolution draws.","operationId":"institutional_record_v1_institutional_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/institutional/query":{"get":{"tags":["Institutional Memory"],"summary":"Institutional Query","description":"Query institutional memory by decision type, tag, or agent.\nReturns relevant precedents for current governance decisions.\nThis is how governance learns from its own history.","operationId":"institutional_query_v1_institutional_query_get","parameters":[{"name":"decision_type","in":"query","required":false,"schema":{"type":"string","default":"","title":"Decision Type"}},{"name":"tag","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tag"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/institutional/summary":{"get":{"tags":["Institutional Memory"],"summary":"Institutional Summary","description":"Institutional memory summary — decision distribution and key lessons.","operationId":"institutional_summary_v1_institutional_summary_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/assurance":{"post":{"tags":["Continuity Assurance"],"summary":"Continuity Assurance","description":"Continuity assurance check — verifies that governance can continue\noperating correctly under conditions of uncertainty, failure, and\nconstitutional stress. This is Mostafa's 'Continuity Assurance' layer:\ngovernance that remains trustworthy even when systems are degraded.","operationId":"continuity_assurance_v1_continuity_assurance_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/history":{"get":{"tags":["Continuity Assurance"],"summary":"Continuity History","description":"History of all continuity assurance checks.","operationId":"continuity_history_v1_continuity_history_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/chain":{"get":{"tags":["Continuity Assurance"],"summary":"Constitutional Chain","description":"Complete constitutional chain of assurance — maps VeriSigil's\ncurrent architecture against Mostafa Monsour's 15-layer model.\nShows exactly which layers are addressed, which are partial,\nand which remain outside VeriSigil's current scope.","operationId":"constitutional_chain_v1_constitutional_chain_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/judgment/form":{"post":{"tags":["Judgment Formation"],"summary":"Judgment Form","description":"Form a governance judgment from multi-dimensional evidence.\nCombines behavioral state, intent alignment, authority status,\nconsequence assessment, and reality verification into a single\nsealed judgment record before admissibility is assessed.\nThis is Mostafa's Judgment Formation layer — the deliberative\nstep between context intelligence and constitutional legitimacy.","operationId":"judgment_form_v1_judgment_form_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/judgment/history":{"get":{"tags":["Judgment Formation"],"summary":"Judgment History List","description":"Judgment formation history — all judgments formed, sealed and auditable.","operationId":"judgment_history_list_v1_judgment_history_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/learning/pattern":{"post":{"tags":["Operational Learning"],"summary":"Learning Pattern","description":"Record an operational learning pattern from governance history.\nOperational learning captures what governance has observed across\nmany decisions and begins to identify patterns that should inform\ndoctrine evolution. This is Mostafa's Operational Learning layer.","operationId":"learning_pattern_v1_learning_pattern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/learning/insights":{"get":{"tags":["Operational Learning"],"summary":"Learning Insights","description":"Synthesised operational learning insights from all recorded patterns.\nShows what VeriSigil has learned from its governance history and\nwhich patterns should trigger doctrine evolution.","operationId":"learning_insights_v1_learning_insights_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/learning/apply":{"post":{"tags":["Operational Learning"],"summary":"Learning Apply","description":"Apply a learned pattern to governance policy.\nTriggers a doctrine evolution event based on operational learning.\nThis closes the loop between Operational Learning and Doctrine Evolution.","operationId":"learning_apply_v1_learning_apply_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/living/reality":{"post":{"tags":["Living Reality"],"summary":"Living Reality","description":"Register the current living reality state for a governed environment.\nLiving Reality is Mostafa's Layer 1 — the continuous, dynamic context\nin which AI systems operate. This endpoint captures a snapshot of the\nreal-world state that governance decisions must account for.","operationId":"living_reality_v1_living_reality_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/context/snapshot":{"post":{"tags":["Living Reality"],"summary":"Context Snapshot","description":"Capture a cryptographically sealed context snapshot at a specific moment.\nUsed to anchor the context in which a governance decision was made —\nenabling faithful replay and forensic reconstruction of the exact\nenvironmental conditions present at execution time.","operationId":"context_snapshot_v1_context_snapshot_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/lifecycle/register":{"post":{"tags":["Constitutional Lifecycle"],"summary":"Lifecycle Register","description":"Register an AI system in the constitutional lifecycle.\nThe constitutional operating lifecycle tracks an AI system from\ninception through operation, evolution, and retirement — ensuring\ngovernance continuity across the full system lifespan.\nThis implements the complete constitutional operating lifecycle\ndescribed by Mostafa Monsour.","operationId":"lifecycle_register_v1_lifecycle_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/lifecycle/status/{system_id}":{"get":{"tags":["Constitutional Lifecycle"],"summary":"Lifecycle Status","description":"Current constitutional lifecycle status for an AI system.\nShows which phases of the constitutional chain have been completed,\nwhich are in progress, and which remain pending.","operationId":"lifecycle_status_v1_lifecycle_status__system_id__get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impact/register":{"post":{"tags":["Civilizational Impact"],"summary":"Impact Register","description":"Register a civilizational impact assessment for a governed AI system.\nVeriSigil does not claim to govern civilizational impact directly —\nthat is beyond any single platform's scope. However, documenting\nthe potential civilizational impact of high-consequence AI systems\nis part of responsible governance. This endpoint seals that assessment.","operationId":"impact_register_v1_impact_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impact/assess":{"post":{"tags":["Civilizational Impact"],"summary":"Impact Assess","description":"Assess the civilizational impact dimension of a proposed AI action.\nReturns an impact profile with scale, reversibility, institutional\noversight requirements, and governance recommendations.\nHonest about VeriSigil's scope limits at this layer.","operationId":"impact_assess_v1_impact_assess_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reality/probe":{"post":{"tags":["Reality Verification Layer"],"summary":"Reality Probe","description":"Active reality probe — queries a registered reality source directly\nto verify a predicate is currently true. Unlike /v1/reality/verify\nwhich checks against a cached anchor, this performs a live probe\nagainst the source system at verification time.","operationId":"reality_probe_v1_reality_probe_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reality/source":{"post":{"tags":["Reality Verification Layer"],"summary":"Reality Source Register","description":"Register a trusted reality source — an authoritative external system\nthat can provide ground truth for predicate verification.\nExamples: identity registries, authority databases, CBN systems,\nregulatory oracles, HR systems.","operationId":"reality_source_register_v1_reality_source_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/judgment/confidence":{"post":{"tags":["Judgment Formation"],"summary":"Judgment Confidence","description":"Compute a detailed judgment confidence score from multiple evidence\nstreams. Returns a weighted confidence score with individual dimension\nscores, uncertainty quantification, and confidence interval.","operationId":"judgment_confidence_v1_judgment_confidence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/judgment/deliberate":{"post":{"tags":["Judgment Formation"],"summary":"Judgment Deliberate","description":"Multi-step deliberation process for complex governance judgments.\nStructured deliberation across competing considerations before\na judgment is formed. Seals the deliberation record so the\nreasoning chain is auditable and independently verifiable.","operationId":"judgment_deliberate_v1_judgment_deliberate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/learning/baseline":{"post":{"tags":["Operational Learning"],"summary":"Learning Baseline","description":"Establish a governance learning baseline for a system or agent.\nThe baseline captures the expected distribution of rulings,\nconsequence tiers, and authority patterns so that future\ndeviations can be detected as significant learning signals.","operationId":"learning_baseline_v1_learning_baseline_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/learning/delta":{"post":{"tags":["Operational Learning"],"summary":"Learning Delta","description":"Compute the governance learning delta — the difference between\nobserved governance patterns and the established baseline.\nSignificant deltas become learning patterns and may trigger\ndoctrine evolution. The delta is sealed for audit purposes.","operationId":"learning_delta_v1_learning_delta_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/lifecycle/advance":{"post":{"tags":["Constitutional Lifecycle"],"summary":"Lifecycle Advance","description":"Advance an AI system to the next constitutional lifecycle phase.\nEach phase advance is sealed — the lifecycle progression is\nimmutable and auditable.","operationId":"lifecycle_advance_v1_lifecycle_advance_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impact/monitor":{"get":{"tags":["Civilizational Impact"],"summary":"Impact Monitor","description":"Continuous civilizational impact monitoring dashboard.\nShows current impact assessments, threshold breaches, and\nsystems approaching high-impact thresholds.","operationId":"impact_monitor_v1_impact_monitor_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/impact/threshold":{"post":{"tags":["Civilizational Impact"],"summary":"Impact Threshold","description":"Set civilizational impact thresholds for a governed system.\nWhen an action exceeds a threshold, VeriSigil automatically\nescalates to institutional oversight regardless of other\ngovernance conditions.","operationId":"impact_threshold_v1_impact_threshold_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/validate":{"post":{"tags":["Continuity Assurance"],"summary":"Constitutional Validate","description":"Validate that a proposed action satisfies constitutional requirements\nacross all 15 layers of the constitutional chain of assurance.\nReturns a layer-by-layer validation result before admissibility\nis formally assessed.","operationId":"constitutional_validate_v1_constitutional_validate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/constitutional/score":{"get":{"tags":["Continuity Assurance"],"summary":"Constitutional Score","description":"Current constitutional health score for the VeriSigil platform itself.\nShows how much of the 15-layer constitutional chain of assurance\nis currently active and operational.","operationId":"constitutional_score_v1_constitutional_score_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/test":{"post":{"tags":["Continuity Assurance"],"summary":"Continuity Test","description":"Run a governance continuity test — simulates failure conditions\nand verifies that governance continues to function correctly.\nTests that DENY/ESCALATE rulings still fire correctly when\nspecific infrastructure components are degraded or unavailable.","operationId":"continuity_test_v1_continuity_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/plan":{"post":{"tags":["Continuity Assurance"],"summary":"Continuity Plan","description":"Create a governance continuity plan for an AI system.\nDocuments what happens to governance when specific failure\nconditions occur — who takes over, what actions are blocked,\nand how governance is restored.","operationId":"continuity_plan_v1_continuity_plan_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/doctrine/propose":{"post":{"tags":["Doctrine Evolution"],"summary":"Doctrine Propose","description":"Propose a governance doctrine change for review and approval.\nUnlike /v1/doctrine/evolve which records an already-approved\nevolution, this creates a proposal that must be voted on before\nit becomes active doctrine.","operationId":"doctrine_propose_v1_doctrine_propose_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/doctrine/vote":{"post":{"tags":["Doctrine Evolution"],"summary":"Doctrine Vote","description":"Vote on a pending doctrine proposal.\nWhen sufficient votes are reached, the proposal is automatically\nconverted to an active doctrine evolution.","operationId":"doctrine_vote_v1_doctrine_vote_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/institutional/precedent":{"get":{"tags":["Institutional Memory"],"summary":"Institutional Precedent","description":"Query institutional precedents for a specific decision type\nand consequence tier. Returns the most relevant past governance\ndecisions that should inform the current judgment formation.","operationId":"institutional_precedent_v1_institutional_precedent_get","parameters":[{"name":"decision_type","in":"query","required":false,"schema":{"type":"string","default":"","title":"Decision Type"}},{"name":"consequence","in":"query","required":false,"schema":{"type":"string","default":"","title":"Consequence"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/institutional/classify":{"post":{"tags":["Institutional Memory"],"summary":"Institutional Classify","description":"Classify a governance decision for institutional memory.\nAssigns decision type, significance level, and memory tags\nto ensure the decision is findable as a precedent for future\ngovernance judgments.","operationId":"institutional_classify_v1_institutional_classify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/value":{"get":{"tags":["Governance Economics"],"summary":"Governance Value","description":"Total governance value delivered to date.\nTranslates cryptographic governance decisions into business outcomes\nthat boards and CFOs understand. Combines risk reduction, cost\navoidance, compliance value, and operational efficiency gains.","operationId":"governance_value_v1_governance_value_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/risk-reduced":{"get":{"tags":["Governance Economics"],"summary":"Governance Risk Reduced","description":"Quantified risk reduction from governance.\nTranslates DENY and ESCALATE decisions into risk exposure reduced.\nShows risk by consequence tier, action type, and time period.\nSpeaks directly to Chief Risk Officers and risk committees.","operationId":"governance_risk_reduced_v1_governance_risk_reduced_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/cost-avoided":{"get":{"tags":["Governance Economics"],"summary":"Governance Cost Avoided","description":"Costs avoided through governance enforcement.\nBreaks down avoided costs by category: incident response,\nregulatory fines, reputational damage, legal exposure,\nand audit preparation. Built for CFO and board reporting.","operationId":"governance_cost_avoided_v1_governance_cost_avoided_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/business-impact":{"get":{"tags":["Governance Economics"],"summary":"Governance Business Impact","description":"Complete business impact summary of governance.\nThe single endpoint for board-level AI governance reporting.\nCombines value delivered, risk reduced, costs avoided, and\noperational metrics into one executive-ready summary.\nBuilt for boards, audit committees, and enterprise procurement.","operationId":"governance_business_impact_v1_governance_business_impact_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/register":{"post":{"tags":["Intent Provenance Layer"],"summary":"Intent Register","description":"Register the declared intent behind an AI action before execution.\nThis is the Intent Provenance Layer — the constitutional anchor\nthat binds every execution to a declared mission and purpose.\n\nNothing should execute without a registered intent. Intent registration\nprecedes reality anchoring, judgment formation, and admissibility\nassessment. It answers the foundational question:\n\nWHY does this action exist?\n\nThe complete constitutional chain becomes:\nMission → Intent → Reality → Evidence → Context → Judgment →\nLegitimacy → Admissibility → Execution → Memory → Learning →\nDoctrine → Continuity → Impact\n\nEvery link in this chain is now sealed and independently verifiable.","operationId":"intent_register_v1_intent_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/{execution_id}":{"get":{"tags":["Intent Provenance Layer"],"summary":"Intent Get","description":"Retrieve the registered intent for a specific execution.\nReturns the sealed intent provenance record — the declared\nmission, purpose, and authority basis behind any governed action.\nUse this to answer: WHY did this action execute?","operationId":"intent_get_v1_intent__execution_id__get","parameters":[{"name":"execution_id","in":"path","required":true,"schema":{"type":"string","title":"Execution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/history":{"get":{"tags":["Intent Provenance Layer"],"summary":"Intent History Endpoint","description":"Complete intent provenance history.\nEvery intent registration, change, conflict, and resolution —\nsealed, immutable, and auditable. Answers: what was the declared\nintent behind every governed action this agent has ever taken?","operationId":"intent_history_endpoint_v1_intent_history_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"action_type","in":"query","required":false,"schema":{"type":"string","default":"","title":"Action Type"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/change":{"post":{"tags":["Intent Provenance Layer"],"summary":"Intent Change","description":"Record a change to a registered intent.\nIntent changes are significant governance events — they indicate\nthat the purpose behind an action has shifted. Every change is\nsealed independently so the provenance chain remains unbroken.\nA changed intent may trigger re-evaluation of admissibility.","operationId":"intent_change_v1_intent_change_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/conflict":{"post":{"tags":["Intent Provenance Layer"],"summary":"Intent Conflict","description":"Register and evaluate an intent conflict.\nIntent conflicts occur when a proposed action's declared intent\ncontradicts the agent's mission, mandate, or a previously\nregistered intent. This is the governance equivalent of a\nconstitutional challenge — resolved before execution proceeds.\n\nTypes of intent conflict:\n- MISSION_CONFLICT: action contradicts declared mission\n- MANDATE_CONFLICT: action exceeds declared mandate scope\n- PRIOR_INTENT_CONFLICT: conflicts with a previously registered intent\n- AUTHORITY_CONFLICT: intent requires authority not held\n- CONSEQUENCE_CONFLICT: consequence tier inconsistent with declared intent","operationId":"intent_conflict_v1_intent_conflict_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/classify":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Classify","description":"EU AI Act Article 6 + Annex III high-risk AI classification.\nDetermines whether an AI system falls under high-risk obligations\nbased on deployment domain and use case.\nRequired before conformity assessment.","operationId":"eu_aiact_classify_v1_eu_aiact_classify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/risk-management":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article9","description":"EU AI Act Article 9 — Risk Management System.\nDocuments and evaluates the risk management system for a high-risk\nAI system. Required throughout the lifecycle of the AI system.\nVeriSigil's six-gate pre-execution governance maps directly to\nArticle 9 risk management obligations.","operationId":"eu_aiact_article9_v1_eu_aiact_risk_management_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article9":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article9","description":"EU AI Act Article 9 — Risk Management System.\nDocuments and evaluates the risk management system for a high-risk\nAI system. Required throughout the lifecycle of the AI system.\nVeriSigil's six-gate pre-execution governance maps directly to\nArticle 9 risk management obligations.","operationId":"eu_aiact_article9_v1_eu_aiact_article9_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/data-governance":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article10","description":"EU AI Act Article 10 — Data and Data Governance.\nDocuments training, validation, and testing data practices.\nIncludes data quality criteria, bias examination, and\ndata governance policies required for high-risk AI systems.","operationId":"eu_aiact_article10_v1_eu_aiact_data_governance_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article10":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article10","description":"EU AI Act Article 10 — Data and Data Governance.\nDocuments training, validation, and testing data practices.\nIncludes data quality criteria, bias examination, and\ndata governance policies required for high-risk AI systems.","operationId":"eu_aiact_article10_v1_eu_aiact_article10_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/technical-documentation":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article11","description":"EU AI Act Article 11 — Technical Documentation.\nGenerates and validates technical documentation required for\nhigh-risk AI systems under Annex IV. VeriSigil's DOI-published\nspecifications and CLARA validation program contribute directly\nto Article 11 compliance.","operationId":"eu_aiact_article11_v1_eu_aiact_technical_documentation_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article11":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article11","description":"EU AI Act Article 11 — Technical Documentation.\nGenerates and validates technical documentation required for\nhigh-risk AI systems under Annex IV. VeriSigil's DOI-published\nspecifications and CLARA validation program contribute directly\nto Article 11 compliance.","operationId":"eu_aiact_article11_v1_eu_aiact_article11_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/record-keeping":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article12","description":"EU AI Act Article 12 — Record-Keeping (Logging).\nDocuments automatic logging capabilities for high-risk AI systems.\nVeriSigil's sealed governance receipts are the Article 12\nrecord-keeping mechanism — every governed action is automatically\nlogged, timestamped, and independently verifiable.","operationId":"eu_aiact_article12_v1_eu_aiact_record_keeping_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article12":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article12","description":"EU AI Act Article 12 — Record-Keeping (Logging).\nDocuments automatic logging capabilities for high-risk AI systems.\nVeriSigil's sealed governance receipts are the Article 12\nrecord-keeping mechanism — every governed action is automatically\nlogged, timestamped, and independently verifiable.","operationId":"eu_aiact_article12_v1_eu_aiact_article12_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/transparency":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article13","description":"EU AI Act Article 13 — Transparency and Provision of Information to Deployers.\nGenerates Article 13-compliant transparency documentation.\nVeriSigil's published proof surface, platform limits, and public\nverification endpoints satisfy Article 13 transparency obligations.","operationId":"eu_aiact_article13_v1_eu_aiact_transparency_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article13":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article13","description":"EU AI Act Article 13 — Transparency and Provision of Information to Deployers.\nGenerates Article 13-compliant transparency documentation.\nVeriSigil's published proof surface, platform limits, and public\nverification endpoints satisfy Article 13 transparency obligations.","operationId":"eu_aiact_article13_v1_eu_aiact_article13_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/human-oversight":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article14","description":"EU AI Act Article 14 — Human Oversight.\nDocuments and validates human oversight measures for high-risk\nAI systems. VeriSigil's ESCALATE ruling and autonomous agent\nDENY upgrade directly implement Article 14 human oversight\nobligations.","operationId":"eu_aiact_article14_v1_eu_aiact_human_oversight_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article14":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article14","description":"EU AI Act Article 14 — Human Oversight.\nDocuments and validates human oversight measures for high-risk\nAI systems. VeriSigil's ESCALATE ruling and autonomous agent\nDENY upgrade directly implement Article 14 human oversight\nobligations.","operationId":"eu_aiact_article14_v1_eu_aiact_article14_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/quality-management":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article17","description":"EU AI Act Article 17 — Quality Management System.\nDocuments the quality management system for high-risk AI providers.\nMaps VeriSigil's governance architecture to Article 17 QMS\nrequirements including strategy, design, data management,\ntesting, and post-market monitoring.","operationId":"eu_aiact_article17_v1_eu_aiact_quality_management_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article17":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article17","description":"EU AI Act Article 17 — Quality Management System.\nDocuments the quality management system for high-risk AI providers.\nMaps VeriSigil's governance architecture to Article 17 QMS\nrequirements including strategy, design, data management,\ntesting, and post-market monitoring.","operationId":"eu_aiact_article17_v1_eu_aiact_article17_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/conformity-assessment":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Conformity","description":"EU AI Act Conformity Assessment (Article 43).\nAssesses conformity with EU AI Act requirements across all\napplicable articles. Generates a conformity assessment record\nthat can be submitted to a notified body or used for self-assessment.","operationId":"eu_aiact_conformity_v1_eu_aiact_conformity_assessment_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/conformity":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Conformity","description":"EU AI Act Conformity Assessment (Article 43).\nAssesses conformity with EU AI Act requirements across all\napplicable articles. Generates a conformity assessment record\nthat can be submitted to a notified body or used for self-assessment.","operationId":"eu_aiact_conformity_v1_eu_aiact_conformity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/ce-marking":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Ce Marking","description":"EU AI Act CE Marking readiness assessment (Article 48).\nCE marking is required for high-risk AI systems placed on the\nEU market. This endpoint assesses readiness and generates the\nDeclaration of Conformity template.","operationId":"eu_aiact_ce_marking_v1_eu_aiact_ce_marking_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/serious-incident":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Incident","description":"EU AI Act Article 73 — Serious Incident Reporting.\nGenerates a serious incident report for submission to the\nnational competent authority. Required within 15 days of\nbecoming aware of a serious incident or malfunction.","operationId":"eu_aiact_incident_v1_eu_aiact_serious_incident_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/incident":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Incident","description":"EU AI Act Article 73 — Serious Incident Reporting.\nGenerates a serious incident report for submission to the\nnational competent authority. Required within 15 days of\nbecoming aware of a serious incident or malfunction.","operationId":"eu_aiact_incident_v1_eu_aiact_incident_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/post-market":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Post Market","description":"EU AI Act Article 72 — Post-Market Monitoring.\nDocuments the post-market monitoring plan for high-risk AI systems.\nVeriSigil's continuous governance monitoring provides the\ntechnical infrastructure for Article 72 post-market obligations.","operationId":"eu_aiact_post_market_v1_eu_aiact_post_market_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/monitoring":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Post Market","description":"EU AI Act Article 72 — Post-Market Monitoring.\nDocuments the post-market monitoring plan for high-risk AI systems.\nVeriSigil's continuous governance monitoring provides the\ntechnical infrastructure for Article 72 post-market obligations.","operationId":"eu_aiact_post_market_v1_eu_aiact_monitoring_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/database":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Register","description":"EU AI Act Article 49 — Registration in EU Database.\nGenerates registration documentation for the EU AI Act database\n(operated by the European AI Office). High-risk AI systems must\nbe registered before being placed on the EU market.","operationId":"eu_aiact_register_v1_eu_aiact_database_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/register":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Register","description":"EU AI Act Article 49 — Registration in EU Database.\nGenerates registration documentation for the EU AI Act database\n(operated by the European AI Office). High-risk AI systems must\nbe registered before being placed on the EU market.","operationId":"eu_aiact_register_v1_eu_aiact_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/dashboard":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Dashboard","description":"EU AI Act compliance dashboard — complete status across all articles.\nSingle endpoint for compliance officers and regulators to see\nthe full EU AI Act compliance posture of a VeriSigil deployment.","operationId":"eu_aiact_dashboard_v1_eu_aiact_dashboard_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/obligations":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Obligations","description":"EU AI Act obligations by role: provider, deployer, importer, distributor.\nReturns the exact obligations applicable to each actor in the AI value chain.","operationId":"eu_aiact_obligations_v1_eu_aiact_obligations_get","parameters":[{"name":"role","in":"query","required":false,"schema":{"type":"string","default":"provider","title":"Role"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/timeline":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Timeline","description":"EU AI Act compliance timeline — all key dates and what became active when.\nCurrent date context: August 2, 2026 — high-risk obligations NOW ACTIVE.","operationId":"eu_aiact_timeline_v1_eu_aiact_timeline_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/evidence-package":{"post":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Evidence Package","description":"EU AI Act Evidence Package Generator.\nGenerates a complete evidence package for regulatory submission,\nnotified body assessment, or conformity self-assessment.\nCombines all Article compliance records into one sealed package.","operationId":"eu_aiact_evidence_package_v1_eu_aiact_evidence_package_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/readiness-score":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Readiness Score","description":"EU AI Act compliance readiness score.\nSingle score showing how ready a deployment is for EU AI Act\nhigh-risk obligations. Built for compliance officers who need\na quick executive view.","operationId":"eu_aiact_readiness_score_v1_eu_aiact_readiness_score_get","parameters":[{"name":"system_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"System Id"}},{"name":"risk_class","in":"query","required":false,"schema":{"type":"string","default":"HIGH_RISK","title":"Risk Class"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/article-map":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Article Map","description":"Article-to-VeriSigil mapping — shows exactly which VeriSigil\ncapabilities satisfy which EU AI Act articles.\nThe definitive reference for compliance officers mapping\nVeriSigil against their EU AI Act obligations.","operationId":"eu_aiact_article_map_v1_eu_aiact_article_map_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/deployer":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Deployer","description":"Article 26 — Deployer obligations checklist and VeriSigil coverage.","operationId":"eu_aiact_deployer_v1_eu_aiact_deployer_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/provider":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Provider","description":"Articles 16-27 — Provider obligations checklist and VeriSigil coverage.","operationId":"eu_aiact_provider_v1_eu_aiact_provider_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/importer":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Importer","description":"Article 23 — Importer obligations checklist.","operationId":"eu_aiact_importer_v1_eu_aiact_importer_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/notified-body":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Notified Body","description":"Notified Body preparation guide.\nEverything needed to prepare for a third-party conformity\nassessment by an EU AI Act notified body.","operationId":"eu_aiact_notified_body_v1_eu_aiact_notified_body_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/gpai":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Gpai","description":"GPAI Model Obligations — Articles 51-56.\nGeneral Purpose AI model compliance requirements.\nActive since August 2025.","operationId":"eu_aiact_gpai_v1_eu_aiact_gpai_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/prohibited":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Prohibited","description":"Article 5 — Prohibited AI Practices.\nComplete list of AI practices prohibited in the EU since February 2025.\nUse this to screen AI systems before deployment.","operationId":"eu_aiact_prohibited_v1_eu_aiact_prohibited_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/annex-iii":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Annex Iii","description":"Complete Annex III high-risk AI system categories.\nFull list of all 8 categories with sub-items and applicable obligations.","operationId":"eu_aiact_annex_iii_v1_eu_aiact_annex_iii_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/eu-aiact/annex-iv":{"get":{"tags":["EU AI Act Compliance"],"summary":"Eu Aiact Annex Iv","description":"Annex IV — Technical Documentation Requirements.\nComplete checklist of all technical documentation elements\nrequired for high-risk AI systems under Article 11.","operationId":"eu_aiact_annex_iv_v1_eu_aiact_annex_iv_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/register":{"post":{"tags":["Input Fidelity Governance"],"summary":"Input Register","description":"Register the declared input set for an AI reasoning or decision task.\nThis is the foundational step of Input Fidelity Governance.\n\nBefore an AI agent reasons toward a consequential decision, it must\ndeclare what inputs it is considering. This registration creates a\nsealed record of the declared input set — enabling downstream\nverification that:\n\n1. The full relevant input set was presented (coverage)\n2. No systematic exclusion occurred (bias detection)\n3. The declared inputs match what was actually processed (faithfulness)\n\nRussell Buzby's finding: Canada's AI excluded 88% of dissenting voices\nwhile appearing accurate. This layer catches that failure BEFORE\nthe consequential output forms.\n\nConstitutional chain position: Layer 1.5 — between Living Reality\nand Reality Verification.","operationId":"input_register_v1_input_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/fidelity":{"post":{"tags":["Input Fidelity Governance"],"summary":"Input Fidelity","description":"Input Fidelity Check — verifies that what an AI agent actually\nprocessed matches what it declared it would consider.\n\nThis is the core governance check of the Input Fidelity layer.\nIt detects the Canada government AI failure mode: an agent that\ndeclares it will consider all inputs but systematically excludes\ndissenting ones before reasoning begins.\n\nReturns: FAITHFUL, PARTIALLY_FAITHFUL, UNFAITHFUL, or SUSPICIOUS.\n\nAn UNFAITHFUL or SUSPICIOUS ruling blocks execution and requires\nhuman review of the input selection process before the AI\nreasoning output can be used for consequential decisions.","operationId":"input_fidelity_v1_input_fidelity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/coverage":{"get":{"tags":["Input Fidelity Governance"],"summary":"Input Coverage","description":"Input coverage score for a registered input set.\nShows what percentage of the available input universe\nwas actually considered. Low coverage is a governance risk\neven when outputs appear accurate.","operationId":"input_coverage_v1_input_coverage_get","parameters":[{"name":"input_set_id","in":"query","required":true,"schema":{"type":"string","title":"Input Set Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/exclusion":{"post":{"tags":["Input Fidelity Governance"],"summary":"Input Exclusion","description":"Exclusion pattern detection — analyses whether excluded inputs\nfollow a non-random pattern that could indicate systematic bias.\n\nThis is the specific check that would have caught the Canada\ngovernment AI failure: dissenting voices excluded at 88% while\nagreeing voices were largely retained.\n\nReturns an exclusion bias score and pattern classification.","operationId":"input_exclusion_v1_input_exclusion_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/audit":{"post":{"tags":["Input Fidelity Governance"],"summary":"Input Audit","description":"Complete input fidelity audit for a governed AI task.\nCombines registration verification, coverage check, exclusion\npattern detection, and faithfulness scoring into one sealed\naudit record suitable for regulatory submission.\n\nThis is the endpoint public sector organisations need when\ndeploying AI for consultation, policy analysis, or any task\nwhere representativeness of inputs matters as much as\naccuracy of outputs.","operationId":"input_audit_v1_input_audit_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/faithfulness":{"post":{"tags":["Input Fidelity Governance"],"summary":"Input Faithfulness","description":"Faithfulness score for an AI output relative to its input set.\nAnswers Russell's question: was the output faithful to ALL\nrelevant inputs, or only to a selected subset?\n\nDifferent from accuracy — an output can be 100% accurate\non the inputs it processed while being entirely unfaithful\nto the full input universe it should have considered.","operationId":"input_faithfulness_v1_input_faithfulness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/bias":{"post":{"tags":["Input Fidelity Governance"],"summary":"Input Bias","description":"Input bias detection — identifies whether input selection\nfavours certain viewpoints, demographics, or source types\nover others in a statistically significant way.\n\nSpecifically designed to detect the participatory exclusion\npattern identified by Russell Buzby: systematic exclusion\nof dissenting or minority voices before AI reasoning forms.","operationId":"input_bias_v1_input_bias_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/provenance":{"get":{"tags":["Input Fidelity Governance"],"summary":"Input Provenance","description":"Complete input provenance record — where every input came from,\nwhat selection criteria were applied, what was excluded and why,\nand whether the selection process was auditable.\n\nThis is the audit trail that answers Russell's question:\n'Who audits whether the dissent survived?'\n\nVeriSigil does.","operationId":"input_provenance_v1_input_provenance_get","parameters":[{"name":"input_set_id","in":"query","required":true,"schema":{"type":"string","title":"Input Set Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/input/alerts":{"get":{"tags":["Input Fidelity Governance"],"summary":"Input Alerts","description":"All input fidelity alerts — detected exclusion patterns,\nfaithfulness failures, and bias findings across all governed\ninput sets. Dashboard view for compliance officers.","operationId":"input_alerts_v1_input_alerts_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/playground":{"get":{"tags":["VeriLanguage (VSL)"],"summary":"Vsl Playground","description":"VSL Playground — 5 ready-to-compile VSL programs covering\nthe most common enterprise governance scenarios.\n\nCopy any example into POST /v1/vsl/compile as vsl_source.\nPress compile. Inspect the AST, bytecode, governance IR,\nand compiled rules. See governance as code in action.\n\nEach example demonstrates a different VSL feature.","operationId":"vsl_playground_v1_vsl_playground_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/prove":{"post":{"tags":["Constitutional Legitimacy Layer"],"summary":"Legitimacy Prove","description":"Mathematical proof that a governance policy satisfies\nconstitutional invariants.\n\nAdvances the claim from:\nExecution ∈ AllowedSet (what VeriSigil already proves)\nto:\nGovernancePolicy ∈ LegitimateSet (what this proves)\n\nReturns a formal proof certificate with invariant satisfaction\nproofs, a proof hash, and independent verifiability instructions.","operationId":"legitimacy_prove_v1_legitimacy_prove_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/invariants":{"get":{"tags":["Constitutional Legitimacy Layer"],"summary":"Legitimacy Invariants","description":"The constitutional invariant set enforced by VeriSigil.\nEvery governance policy evaluated against these invariants.\nNo auth required — invariants are public constitutional commitments.","operationId":"legitimacy_invariants_v1_legitimacy_invariants_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/challenge":{"post":{"tags":["Constitutional Legitimacy Layer"],"summary":"Legitimacy Challenge","description":"Formal constitutional legitimacy challenge.\nAny system, regulator, or auditor can formally challenge\nwhether a governance policy has the constitutional right to exist.\nEvery challenge is sealed and triggers formal review.","operationId":"legitimacy_challenge_v1_legitimacy_challenge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/appeal":{"post":{"tags":["Constitutional Legitimacy Layer"],"summary":"Legitimacy Appeal","description":"Formal appeal of a legitimacy ruling.\nConstitutional legitimacy should never be absolute —\nit must itself be governable. This endpoint allows\nformal appeal of any legitimacy evaluation or challenge outcome.","operationId":"legitimacy_appeal_v1_legitimacy_appeal_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intent/origin":{"post":{"tags":["Constitutional Legitimacy Layer"],"summary":"Intent Origin","description":"Intent Origin Verification — was the original intent authentic\nbefore any manipulation could occur?\n\nThis addresses the deepest governance gap: an agent can execute\ncorrectly, evidence can be complete, authority can be valid —\nyet the upstream intent that set everything in motion may have\nbeen corrupted before governance ever saw it.\n\nVerifies:\n- Who originated this intent (human, agent, system, scheduled)\n- Was the origin authenticated at the moment of intent formation?\n- Has the intent been modified since origination?\n- Is there a traceable chain from origin to current intent?","operationId":"intent_origin_v1_intent_origin_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/decision/existence":{"post":{"tags":["Constitutional Legitimacy Layer"],"summary":"Decision Existence","description":"Decision Existence Audit — should this decision exist at all?\n\nThis is the deepest governance question. Not:\n\"Should this action proceed?\" (admissibility)\nNot: \"Is this governance rule valid?\" (legitimacy)\nBut: \"Should this decision have been created in the first place?\"\n\nSometimes the safest execution is not denial.\nSometimes it is proving that the decision itself should\nnever have been created.\n\nExample: Should an AI have been commissioned to summarise\npublic consultation in the first place, and under what\nconstitutional authority?","operationId":"decision_existence_v1_decision_existence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/decision/existence/{decision_id}":{"get":{"tags":["Constitutional Legitimacy Layer"],"summary":"Decision Existence Get","description":"Retrieve the existence audit for a specific decision.","operationId":"decision_existence_get_v1_decision_existence__decision_id__get","parameters":[{"name":"decision_id","in":"path","required":true,"schema":{"type":"string","title":"Decision Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/register":{"post":{"tags":["Consequence Accountability"],"summary":"Consequence Register","description":"Register a real-world consequence of a governed AI decision.\nThis is the missing layer nobody has built:\n\nVeriSigil governs the decision. This endpoint governs what\nhappens AFTER the decision — when it turns out to produce\na real-world consequence.\n\nLinks the consequence back to the governance decision that\nauthorised it, enabling:\n- Consequence-to-decision traceability (INV-008)\n- Accountability when consequence exceeds predicted tier\n- Evidence that governance prediction was accurate or inaccurate\n- Automatic escalation when consequence was wrong\n\nThis is Phase 4 — Governed Sink Integration — beginning.","operationId":"consequence_register_v1_consequence_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/verify":{"post":{"tags":["Consequence Accountability"],"summary":"Consequence Verify","description":"Verify that a registered consequence is genuinely linked to\na governed decision. Checks the cryptographic chain from\nconsequence back to the original governance receipt.","operationId":"consequence_verify_v1_consequence_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/chain/{decision_id}":{"get":{"tags":["Consequence Accountability"],"summary":"Consequence Chain","description":"Complete decision-to-consequence evidence chain.\nShows every consequence registered against a governed decision,\ntheir predicted vs actual tiers, accountability rulings,\nand the cryptographic links between them.\n\nThis is the endpoint that answers: what did this governed\ndecision actually cause in the real world?","operationId":"consequence_chain_v1_consequence_chain__decision_id__get","parameters":[{"name":"decision_id","in":"path","required":true,"schema":{"type":"string","title":"Decision Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/predict":{"post":{"tags":["Consequence Accountability"],"summary":"Consequence Predict","description":"Pre-execution consequence prediction with confidence scoring.\nBefore a governed action executes, predicts the likely real-world\nconsequence tier, scope, and affected parties.\nWhen the actual consequence is registered via POST /v1/consequence/register,\nVeriSigil compares prediction to reality and flags governance calibration gaps.\nThis closes the consequence accountability loop.","operationId":"consequence_predict_v1_consequence_predict_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/accountability":{"get":{"tags":["Consequence Accountability"],"summary":"Consequence Accountability Dashboard","description":"Consequence Accountability Dashboard.\nOverview of all registered consequences, governance prediction\naccuracy, accountability failures, and tier gap distribution.\nThe executive view of whether VeriSigil's consequence predictions\nwere accurate in production.","operationId":"consequence_accountability_dashboard_v1_consequence_accountability_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/score":{"get":{"tags":["Constitutional Legitimacy Layer"],"summary":"Legitimacy Score Dashboard","description":"Constitutional Legitimacy Score Dashboard.\nPlatform-level legitimacy health across all evaluated policies.\nShows distribution of legitimate vs illegitimate policies,\nmost common invariant violations, and legitimacy trend.","operationId":"legitimacy_score_dashboard_v1_legitimacy_score_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/history":{"get":{"tags":["Constitutional Legitimacy Layer"],"summary":"Legitimacy History","description":"Complete legitimacy evaluation history — all policies evaluated,\nchallenged, and appealed. Immutable audit trail of governance\nlegitimacy decisions.","operationId":"legitimacy_history_v1_legitimacy_history_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/decision/should-exist":{"post":{"tags":["Constitutional Legitimacy Layer"],"summary":"Decision Should Exist","description":"Rapid decision existence check — a lighter version of\nPOST /v1/decision/existence for fast pre-execution screening.\n\nAnswers the three-tier question framework:\nTier 1: Can AI do this? (capability — not VeriSigil's question)\nTier 2: Should AI do this? (admissibility — VeriSigil's core)\nTier 3: Should this decision exist at all? (THIS ENDPOINT)\n\nReturns a binary SHOULD_EXIST / SHOULD_NOT_EXIST verdict\nwith the primary reason.","operationId":"decision_should_exist_v1_decision_should_exist_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/legitimacy":{"get":{"tags":["Constitutional Legitimacy Layer"],"summary":"Governance Legitimacy","description":"Governance Legitimacy Synthesis — the complete view of whether\nVeriSigil's own governance framework is constitutionally legitimate.\n\nThis is VeriSigil applying the Constitutional Legitimacy Layer\nto itself. The governance of governance, applied to the governor.\n\nReturns VeriSigil's own legitimacy score, invariant satisfaction,\nand honest statement of what has and has not been proven.","operationId":"governance_legitimacy_v1_governance_legitimacy_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/legitimacy-report":{"get":{"tags":["Constitutional Legitimacy Layer"],"summary":"Governance Legitimacy Report","description":"Complete Constitutional Legitimacy Report — the single endpoint\nthat synthesises everything VGS-050 introduces into one\nboard-ready, regulator-ready, procurement-ready document.\n\nCombines: legitimacy score, consequence accountability,\nintent origin statistics, decision existence audits,\nchallenge history, and honest scope statement.","operationId":"governance_legitimacy_report_v1_governance_legitimacy_report_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/govern":{"post":{"tags":["AI Memory Governance (AMG)"],"summary":"Memory Govern","description":"Govern an AI memory record — classify it, score it, set\nexpiry, and seal it cryptographically.\n\nToday's AI systems remember things, but very few govern\nWHY something is remembered, HOW LONG, and WHETHER it\nshould influence future reasoning.\n\nThis prevents:\n- Memory poisoning (false or manipulated memories)\n- Stale knowledge influencing current decisions\n- Hidden bias accumulation over time","operationId":"memory_govern_v1_memory_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/score":{"post":{"tags":["AI Memory Governance (AMG)"],"summary":"Memory Score","description":"Score the trustworthiness and relevance of a memory record.","operationId":"memory_score_v1_memory_score_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/verify":{"post":{"tags":["AI Memory Governance (AMG)"],"summary":"Memory Verify","description":"Verify a governed memory record is intact and unexpired.","operationId":"memory_verify_v1_memory_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/expire":{"post":{"tags":["AI Memory Governance (AMG)"],"summary":"Memory Expire","description":"Explicitly expire a governed memory — remove it from active reasoning influence.","operationId":"memory_expire_v1_memory_expire_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/health":{"get":{"tags":["AI Memory Governance (AMG)"],"summary":"Memory Health","description":"Memory governance health for an agent — freshness, quality, expiry distribution.","operationId":"memory_health_v1_memory_health_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/state":{"post":{"tags":["Cognitive State Monitoring (CSM)"],"summary":"Cognitive State","description":"Record and evaluate the cognitive state of an AI agent.\nContinuously measures uncertainty, confidence, drift,\nand reasoning stability — the ECG for AI reasoning.\n\nInstead of checking only outputs, CSM watches the AI itself.","operationId":"cognitive_state_v1_cognitive_state_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/uncertainty":{"post":{"tags":["Cognitive State Monitoring (CSM)"],"summary":"Cognitive Uncertainty","description":"Measure and govern AI uncertainty — when uncertainty is too high, escalate before deciding.","operationId":"cognitive_uncertainty_v1_cognitive_uncertainty_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/confidence":{"post":{"tags":["Cognitive State Monitoring (CSM)"],"summary":"Cognitive Confidence","description":"Monitor AI confidence levels — low confidence on consequential decisions requires human review.","operationId":"cognitive_confidence_v1_cognitive_confidence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/drift":{"post":{"tags":["Cognitive State Monitoring (CSM)"],"summary":"Cognitive Drift","description":"Detect cognitive drift — when an agent's reasoning pattern has shifted from its governed baseline.","operationId":"cognitive_drift_v1_cognitive_drift_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/contradiction":{"post":{"tags":["Cognitive State Monitoring (CSM)"],"summary":"Cognitive Contradiction","description":"Detect internal contradictions in AI reasoning — when outputs conflict with prior governed decisions.","operationId":"cognitive_contradiction_v1_cognitive_contradiction_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/cognitive/ecg/{agent_id}":{"get":{"tags":["Cognitive State Monitoring (CSM)"],"summary":"Cognitive Ecg","description":"Cognitive ECG — the complete reasoning health picture for an agent.\nLike a cardiac ECG, shows the rhythm of an agent's cognitive state\nover time. Detects anomalies, drift, and degradation patterns.","operationId":"cognitive_ecg_v1_cognitive_ecg__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ledger/record":{"post":{"tags":["Internal Decision Ledger (IDL)"],"summary":"Ledger Record","description":"Record an internal decision receipt to the governed ledger.\nEvery important AI decision receives a structured reasoning record showing:\n- inputs considered and discarded\n- governing policy applied\n- confidence level\n- consequence assessment\n\nNot blockchain. Not logging.\nA constitutional reasoning record.","operationId":"ledger_record_v1_ledger_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ledger/receipt/{receipt_id}":{"get":{"tags":["Internal Decision Ledger (IDL)"],"summary":"Ledger Receipt","description":"Retrieve a specific internal decision receipt from the ledger.","operationId":"ledger_receipt_v1_ledger_receipt__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ledger/query":{"get":{"tags":["Internal Decision Ledger (IDL)"],"summary":"Ledger Query","description":"Query the internal decision ledger — filter by agent, decision type, or consequence.","operationId":"ledger_query_v1_ledger_query_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"decision_type","in":"query","required":false,"schema":{"type":"string","default":"","title":"Decision Type"}},{"name":"consequence_level","in":"query","required":false,"schema":{"type":"string","default":"","title":"Consequence Level"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ledger/audit":{"get":{"tags":["Internal Decision Ledger (IDL)"],"summary":"Ledger Audit","description":"Complete audit of the internal decision ledger — reasoning patterns, confidence distribution, discard rates.","operationId":"ledger_audit_v1_ledger_audit_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trajectory/record":{"post":{"tags":["Behavioral Trajectory Intelligence (BTI)"],"summary":"Trajectory Record","description":"Record a behavioral trajectory data point for an agent.\nBTI asks not \"was this decision correct?\" but\n\"is the overall behaviour drifting across hundreds of decisions?\"\nDetects problems long before any single action violates a rule.","operationId":"trajectory_record_v1_trajectory_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trajectory/score/{agent_id}":{"get":{"tags":["Behavioral Trajectory Intelligence (BTI)"],"summary":"Trajectory Score","description":"Behavioral trajectory score — is this agent's behaviour stable or drifting?","operationId":"trajectory_score_v1_trajectory_score__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trajectory/drift":{"post":{"tags":["Behavioral Trajectory Intelligence (BTI)"],"summary":"Trajectory Drift","description":"Compute behavioral trajectory drift — how far has this agent drifted from its governance baseline?","operationId":"trajectory_drift_v1_trajectory_drift_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trajectory/predict":{"post":{"tags":["Behavioral Trajectory Intelligence (BTI)"],"summary":"Trajectory Predict","description":"Predict future behavioral trajectory — where is this agent heading if current drift continues?","operationId":"trajectory_predict_v1_trajectory_predict_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/coordination/register":{"post":{"tags":["Multi-Agent Coordination Governance (MACG)"],"summary":"Coordination Register","description":"Register an agent in the multi-agent coordination governance system.\nFuture AI won't work alone — agents will negotiate, delegate,\ncollaborate, vote, and exchange tasks.\nCurrent governance mostly treats each agent independently.\nMACG governs the system as a whole.","operationId":"coordination_register_v1_coordination_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/coordination/negotiate":{"post":{"tags":["Multi-Agent Coordination Governance (MACG)"],"summary":"Coordination Negotiate","description":"Govern a multi-agent negotiation.\nWhen agents negotiate over resources, tasks, or decisions,\nMACG ensures the negotiation itself is governed — authority\nchecks, outcome sealing, and audit trail.","operationId":"coordination_negotiate_v1_coordination_negotiate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/coordination/delegate":{"post":{"tags":["Multi-Agent Coordination Governance (MACG)"],"summary":"Coordination Delegate","description":"Govern an inter-agent delegation.\nWhen one agent delegates authority or tasks to another,\nMACG checks delegation depth limits, authority scope\ncompatibility, and seals the delegation record.","operationId":"coordination_delegate_v1_coordination_delegate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/coordination/vote":{"post":{"tags":["Multi-Agent Coordination Governance (MACG)"],"summary":"Coordination Vote","description":"Govern a multi-agent vote.\nWhen agents vote on decisions, MACG governs the vote —\nverifying voter eligibility, weighting votes by governed\nauthority, and sealing the outcome.","operationId":"coordination_vote_v1_coordination_vote_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/coordination/health":{"get":{"tags":["Multi-Agent Coordination Governance (MACG)"],"summary":"Coordination Health","description":"Multi-agent system health — governance coverage across all\nregistered agents and their coordination activity.\nThe system-level view of the multi-agent governance environment.","operationId":"coordination_health_v1_coordination_health_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/transaction":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Transaction","description":"Govern an autonomous AI commercial transaction before it executes.\nCovers B2B, B2C, marketplace, and cross-border transactions.\n\nAI commerce agents that autonomously execute purchases, sales,\nor transfers must pass governance before funds move or\ncontracts are formed. This endpoint is the pre-execution\ngate for any AI-initiated commercial action.\n\nConsequence tiers for commerce:\n- ADVISORY: browsing, recommendations, price checks\n- OPERATIONAL: small purchases, standard orders\n- HIGH: large purchases, vendor contracts\n- CRITICAL: major contracts, cross-border, irreversible\n- EMERGENCY: system-critical procurement","operationId":"commerce_transaction_v1_commerce_transaction_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/purchase":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Purchase","description":"Govern an AI-autonomous purchase order.\nValidates purchase authority, budget limits, vendor trust,\nand compliance before any commitment is made.","operationId":"commerce_purchase_v1_commerce_purchase_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/pricing":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Pricing","description":"Govern AI-driven dynamic pricing decisions.\nPrevents predatory pricing, price discrimination,\nand pricing actions that violate regulatory limits.\nCritical for AI commerce agents managing real-time pricing.","operationId":"commerce_pricing_v1_commerce_pricing_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/refund":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Refund","description":"Govern AI-autonomous refund decisions.\nEnsures refunds are within authorised limits, properly\nverified, and sealed with evidence before funds move.","operationId":"commerce_refund_v1_commerce_refund_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/fraud":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Fraud","description":"AI Commerce fraud governance — evaluates fraud signals\nbefore any commercial action executes.\nReturns fraud risk score, signals detected, and governance ruling.","operationId":"commerce_fraud_v1_commerce_fraud_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/vendor":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Vendor","description":"Govern AI-autonomous vendor selection and onboarding.\nWhen an AI agent selects, onboards, or contracts a vendor\nautonomously, this endpoint validates authority, due\ndiligence requirements, and contract limits.","operationId":"commerce_vendor_v1_commerce_vendor_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/marketplace":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Marketplace","description":"Govern AI agent actions on marketplace platforms.\nCovers listing, bidding, buying, selling, and review\nmanipulation detection. Applicable to Amazon, eBay,\nJumia, Konga, and enterprise procurement marketplaces.","operationId":"commerce_marketplace_v1_commerce_marketplace_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/escrow":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Escrow","description":"Govern AI-managed escrow operations.\nAI agents managing escrow accounts for marketplace transactions,\nreal estate, or B2B contracts must pass governance before\nreleasing, holding, or returning funds.","operationId":"commerce_escrow_v1_commerce_escrow_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/dispute":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Dispute","description":"Govern AI-autonomous dispute resolution.\nWhen AI agents handle commercial disputes — chargebacks,\ndelivery failures, quality disputes — this endpoint\ngoverns the resolution decision before it is executed.","operationId":"commerce_dispute_v1_commerce_dispute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commerce/inventory":{"post":{"tags":["AI Commerce Governance"],"summary":"Commerce Inventory","description":"Govern AI-autonomous inventory management decisions.\nWhen AI agents autonomously reorder, write off, transfer,\nor liquidate inventory, this governs the action before\nstock moves or commitments are made.","operationId":"commerce_inventory_v1_commerce_inventory_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/healthcare/govern":{"post":{"tags":["Industry Vertical Governance"],"summary":"Healthcare Govern","description":"Healthcare AI Governance — pre-execution governance for\nAI agents in clinical, diagnostic, and treatment workflows.\n\nConsequence tiers for healthcare:\n- ADVISORY: informational queries, appointment scheduling\n- OPERATIONAL: administrative tasks, record access\n- HIGH: diagnostic assistance, treatment recommendations\n- CRITICAL: prescriptions, surgical decisions, medication orders\n- EMERGENCY: life-critical interventions\n\nRegulatory: HIPAA, FDA AI/ML guidance, EU AI Act Annex III §5a","operationId":"healthcare_govern_v1_healthcare_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legal/govern":{"post":{"tags":["Industry Vertical Governance"],"summary":"Legal Govern","description":"Legal AI Governance — governs AI agents in legal workflows.\nContract drafting, legal research, filing, advice generation.\n\nCritical: AI cannot provide legal advice without qualified\nhuman oversight in most jurisdictions. This endpoint enforces\nthat boundary and seals the evidence.","operationId":"legal_govern_v1_legal_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/realestate/govern":{"post":{"tags":["Industry Vertical Governance"],"summary":"Realestate Govern","description":"Real Estate AI Governance — governs AI agents in property\ntransactions, valuations, tenant screening, and lease management.\nHigh-consequence decisions due to transaction size and\nfair housing compliance requirements.","operationId":"realestate_govern_v1_realestate_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/insurance/govern":{"post":{"tags":["Industry Vertical Governance"],"summary":"Insurance Govern","description":"Insurance AI Governance — governs AI agents in underwriting,\nclaims, pricing, and coverage decisions.\nPrevents discriminatory underwriting and governs automated\nclaims decisions above authorised thresholds.","operationId":"insurance_govern_v1_insurance_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/logistics/govern":{"post":{"tags":["Industry Vertical Governance"],"summary":"Logistics Govern","description":"Logistics AI Governance — governs autonomous AI in supply chain,\nroute optimisation, fleet management, and delivery operations.\nCritical for last-mile delivery AI in Nigerian and African markets.","operationId":"logistics_govern_v1_logistics_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/energy/govern":{"post":{"tags":["Industry Vertical Governance"],"summary":"Energy Govern","description":"Energy AI Governance — governs AI agents managing power grids,\nrenewable dispatch, energy trading, and consumption optimisation.\nCritical infrastructure — highest governance standards apply.","operationId":"energy_govern_v1_energy_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/correctness":{"post":{"tags":["Provable Execution Integrity"],"summary":"Proof Correctness","description":"Decision Correctness Proof — proves that f(policy, inputs) = output.\n\nConsequence-boundary gap: \"a signed log entry proves a record wasn't altered\nafter the fact; it does not prove the engine computed the decision\nfaithfully from the stated policy and inputs.\"\n\nThis endpoint closes Gap 1 (Correctness). It records the exact\npolicy function applied, the exact inputs, and the exact output,\nin a form that any third party can independently recompute.\n\nHONEST BOUNDARY (from §2.2 of consequence-custody-spec.md):\nThis proves f(policy, inputs) = output for the DETERMINISTIC\nrule-based components of the policy function ONLY.\nIt does NOT prove:\n- the policy itself was the correct one to apply\n- the inputs were true or complete\n- the consequence-tier classification was reasonable\n- anything about ML/LLM components in the reasoning path\n\nPublishing this boundary is not a weakness. It is what makes\nthe 'Verified' half credible.","operationId":"proof_correctness_v1_proof_correctness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/policy-trace":{"post":{"tags":["Provable Execution Integrity"],"summary":"Proof Policy Trace","description":"Policy trace — the complete, step-by-step record of how a\ngovernance decision was computed. Every gate evaluated, every\nthreshold checked, every authority validated — in sequence,\nwith inputs and outputs at each step.\n\nThis is what a third-party auditor uses to independently\nverify not just that the output is correct but HOW it\nwas reached, which gates fired, and which didn't.","operationId":"proof_policy_trace_v1_proof_policy_trace_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ao/issue":{"post":{"tags":["Provable Execution Integrity"],"summary":"Ao Issue","description":"Issue an Authorization Object (AO) — the structural mechanism\nthat closes Gap 2 (Custody).\n\nConsequence-boundary gap: \"the endpoint governed a real consequence-bearing\nsystem — the route was non-bypassable.\"\n\nThe AO architecture changes the structure:\nBEFORE: verdict signed → downstream decides whether to obey\nAFTER:  AO issued → actuator CANNOT execute without valid AO\n\nThe AO is not a checked field. It is a structural precondition.\nThe actuator's execute function requires a valid, fresh,\nsingle-use AO as an argument — a missing capability, not\nan unchecked flag.\n\nEvery AO is:\n- Single-use (nonce consumed on first verification)\n- Fresh (bound to current state commitment)\n- Scoped (only valid for declared action + agent + actuator)\n- Time-limited (TTL enforced)\n- Cryptographically sealed","operationId":"ao_issue_v1_ao_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ao/verify":{"post":{"tags":["Provable Execution Integrity"],"summary":"Ao Verify","description":"Verify and consume an Authorization Object.\nCalled by the actuator immediately before executing.\n\nReturns VALID_AND_UNCONSUMED (proceed) or a rejection reason.\nConsuming the AO makes it single-use — replay attacks return\nALREADY_CONSUMED.\n\nThis is what closes the bypass gap structurally:\nthe actuator calls this endpoint and only proceeds if it\nreturns VALID_AND_UNCONSUMED. Any other response = halt.","operationId":"ao_verify_v1_ao_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ao/consume":{"post":{"tags":["Provable Execution Integrity"],"summary":"Ao Consume","description":"Explicitly consume an AO without verifying — for actuators\nthat verify externally but need to record consumption.","operationId":"ao_consume_v1_ao_consume_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ao/status/{ao_id}":{"get":{"tags":["Provable Execution Integrity"],"summary":"Ao Status","description":"AO status — VALID, CONSUMED, EXPIRED, or NOT_FOUND.","operationId":"ao_status_v1_ao_status__ao_id__get","parameters":[{"name":"ao_id","in":"path","required":true,"schema":{"type":"string","title":"Ao Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ao/nonce":{"get":{"tags":["Provable Execution Integrity"],"summary":"Ao Nonce Ledger","description":"Nonce ledger — all consumed nonces. Any nonce in this set\nhas already been used and will be rejected on replay.\nThis is the replay-attack prevention record.","operationId":"ao_nonce_ledger_v1_ao_nonce_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/state/commit":{"post":{"tags":["Provable Execution Integrity"],"summary":"State Commit","description":"State Commitment — binds an authorization to a specific\nsnapshot of the world at the moment of authorization.\n\nConsequence-boundary gap: \"changed conditions forced requalification.\"\n\nIf authority is revoked, budget is exhausted, or any\nmaterial state changes after the AO was issued, the\nstate_hash will not match — and the AO is invalid.\n\nThis is Gap 4 from consequence-custody-spec.md §4:\n\"state freshness\" — the authorization was bound to\nfresh state at the moment of use.","operationId":"state_commit_v1_state_commit_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/state/verify":{"post":{"tags":["Provable Execution Integrity"],"summary":"State Verify","description":"Verify current state matches a previously committed state hash.\nCalled at execution time to confirm state hasn't changed\nbetween authorization and execution.","operationId":"state_verify_v1_state_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/state/freshness/{commitment_id}":{"get":{"tags":["Provable Execution Integrity"],"summary":"State Freshness","description":"State freshness check — is this commitment still within its TTL?","operationId":"state_freshness_v1_state_freshness__commitment_id__get","parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","title":"Commitment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threshold/sign":{"post":{"tags":["Provable Execution Integrity"],"summary":"Threshold Sign","description":"Threshold signature session for CRITICAL/EMERGENCY actions.\nGap 3 from consequence-custody-spec.md §5:\n\"even a custody-bound decision is authorized by one party's\nkey alone, unless independently co-signed.\"\n\nCRITICAL and EMERGENCY actions require k-of-n signers.\nNo single party can authorize alone.\n\nHONEST BOUNDARY: threshold is only as strong as the\nindependence of the second signer. An internal service\ndressed as an external auditor provides no benefit.\nThe second signer must be genuinely separately operated.","operationId":"threshold_sign_v1_threshold_sign_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threshold/verify":{"post":{"tags":["Provable Execution Integrity"],"summary":"Threshold Verify","description":"Verify a threshold session is complete and all signatures are valid.","operationId":"threshold_verify_v1_threshold_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threshold/quorum":{"get":{"tags":["Provable Execution Integrity"],"summary":"Threshold Quorum","description":"Threshold quorum overview — all sessions and their completion status.","operationId":"threshold_quorum_v1_threshold_quorum_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/payload":{"post":{"tags":["Provable Execution Integrity"],"summary":"Continuity Payload","description":"Payload continuity seal — hash the exact payload authorized\nso any modification between gate and actuator is detectable.\n\nGap 4 from consequence-custody-spec.md §6:\n\"even a co-signed decision could still be substituted or\naltered somewhere between authorization and the actuator,\nunless every hop checks.\"\n\nRegister the authorized payload hash here. The actuator\nverifies the hash matches before executing.","operationId":"continuity_payload_v1_continuity_payload_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/hop":{"post":{"tags":["Provable Execution Integrity"],"summary":"Continuity Hop","description":"Record a pipeline hop — each system that touches the payload\nbetween authorization and execution records its hop here.\nAny modification at any hop is detectable from the chain.","operationId":"continuity_hop_v1_continuity_hop_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/pipeline/{pipeline_id}":{"get":{"tags":["Provable Execution Integrity"],"summary":"Continuity Pipeline","description":"Complete pipeline integrity record — all hops, all hash checks.","operationId":"continuity_pipeline_v1_continuity_pipeline__pipeline_id__get","parameters":[{"name":"pipeline_id","in":"path","required":true,"schema":{"type":"string","title":"Pipeline Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/close":{"post":{"tags":["Provable Execution Integrity"],"summary":"Consequence Close","description":"Closed-loop consequence confirmation — the downstream system\nconfirms back to VeriSigil what actually happened.\n\nGap 5 from consequence-custody-spec.md §7:\n\"even a continuity-verified execution doesn't prove the\nreal world actually changed the way the receipt claims.\"\n\nThe downstream system (the actual actuator — payment system,\nHR system, clinical system) calls this endpoint after\nexecution to confirm the real-world outcome.\n\nThis is what \"consequence verification\" means: not VeriSigil\nasserting what happened, but the downstream system confirming it.\n\nHONEST BOUNDARY: this depends on the downstream system being\nindependently queryable. State per action type whether this\nprimitive applies or not.","operationId":"consequence_close_v1_consequence_close_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/confirm":{"post":{"tags":["Provable Execution Integrity"],"summary":"Consequence Confirm","description":"Confirm that a closed-loop consequence matches the\nauthorized action — comparing what was authorized to\nwhat the downstream system says actually happened.","operationId":"consequence_confirm_v1_consequence_confirm_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/consequence/reality":{"post":{"tags":["Provable Execution Integrity"],"summary":"Consequence Reality","description":"Reality verification — independent query of the downstream\nsystem of record after execution to confirm outcome.\n\nThis is row 5 of the verification table from §9 of\nconsequence-custody-spec.md:\n\"Independent query of the downstream system of record\nafter execution — Consequence, not just an internal log.\"","operationId":"consequence_reality_v1_consequence_reality_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verify/kit":{"get":{"tags":["Independent Verification Kit"],"summary":"Verify Kit","description":"Independent Verification Kit — NO AUTHENTICATION REQUIRED.\nEverything a security engineer needs to independently verify\nVeriSigil's claims without any cooperation from VeriSigil.","operationId":"verify_kit_v1_verify_kit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verify/bypass-test":{"post":{"tags":["Independent Verification Kit"],"summary":"Verify Bypass Test","description":"Bypass test — attempt to trigger an action without a valid AO.\nThe system must reject this. If it does not, the custody claim fails.\n\nConsequence-boundary test requirement: a test that proves the route\nis non-bypassable — not a claim, an independently runnable test.","operationId":"verify_bypass_test_v1_verify_bypass_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verify/replay-test":{"post":{"tags":["Independent Verification Kit"],"summary":"Verify Replay Test","description":"Replay attack test — attempt to reuse a consumed AO.\nMust return ALREADY_CONSUMED. If it does not, replay\nattack prevention has failed.","operationId":"verify_replay_test_v1_verify_replay_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verify/nonce-test":{"post":{"tags":["Independent Verification Kit"],"summary":"Verify Nonce Test","description":"Nonce replay test — verify that a specific nonce in the\nconsumed ledger is rejected on re-presentation.","operationId":"verify_nonce_test_v1_verify_nonce_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verify/conformance":{"get":{"tags":["Independent Verification Kit"],"summary":"Verify Conformance","description":"Published conformance vectors — the test cases that any\nindependent party can run to verify VeriSigil's behavior.\n\nFrom enterprise-credibility-roadmap.md §3:\n\"Run the published conformance vectors themselves.\"\n\nThese are the exact inputs and expected outputs that prove\nVeriSigil behaves as claimed. If the outputs differ,\nthe system has deviated from specification.","operationId":"verify_conformance_v1_verify_conformance_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verified-boundary":{"get":{"tags":["Provable Execution Integrity"],"summary":"Verified Boundary","description":"THE VERIFIED BOUNDARY STATEMENT.\n\nNo authentication required. This is the first document\nany security reviewer, enterprise buyer, or technical\ncritic should read.\n\nIt states precisely what VeriSigil has verified and what\nit has not. Publishing both halves equally is what makes\nthe 'Verified' half credible.\n\nThe expert said: \"This page alone gives VeriSigilAI\ntremendous credibility because it tells reviewers exactly\nwhere the guarantees stop.\"\n\nThis discipline applies to systems that overclaim.\nA system that publishes its own honest limits — prominently,\nnot buried — is a different category of system.","operationId":"verified_boundary_v1_verified_boundary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/policy-registry":{"get":{"tags":["Provable Execution Integrity"],"summary":"Proof Policy Registry","description":"Public policy registry — lists all registered deterministic\npolicy functions with their source code hashes.\n\nAny auditor can independently verify that the hash of a\nseparately-obtained copy of the policy source matches what\nis registered here. No ZK required — nothing is hidden from\nauditors. This is the complete 'verifiable computation' claim\nfor VeriSigil's deterministic policy sub-decisions.\n\nNo authentication required — policy hashes are public.","operationId":"proof_policy_registry_v1_proof_policy_registry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/policy-evaluate":{"post":{"tags":["Provable Execution Integrity"],"summary":"Proof Policy Evaluate","description":"Evaluate a registered policy and return a DecisionProof.\nThe proof includes the policy source hash, inputs, and output —\neverything an independent auditor needs to recompute and verify.","operationId":"proof_policy_evaluate_v1_proof_policy_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/tier-requirements":{"get":{"tags":["Provable Execution Integrity"],"summary":"Proof Tier Requirements","description":"Published tier requirements — TTL and co-signer count per consequence tier.\nPublic commitment to how VeriSigil's AO architecture behaves by tier.\nNo authentication required.","operationId":"proof_tier_requirements_v1_proof_tier_requirements_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/compute":{"post":{"tags":["Governance Reputation Layer"],"summary":"Reputation Compute","description":"Compute the Governance Reputation Score for an agent or organisation.\n\nFormula is published and independently recomputable from sealed\nexecution receipts. Not self-reported. Not opinion. Computed from\nverifiable governance evidence.\n\nHONEST BOUNDARY: reputation quality is proportional to production\nexecution volume. A score computed from 25 CLARA validation runs\nreflects validation behavior. A score from 50,000 production\nexecutions reflects production trustworthiness. These are different.\nThe data_source field distinguishes them.","operationId":"reputation_compute_v1_reputation_compute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/score/{agent_id}":{"get":{"tags":["Governance Reputation Layer"],"summary":"Reputation Score","description":"Retrieve the current Governance Reputation Score for an agent.\nIncludes score, grade, component breakdown, data source, and\nhonest boundary statement.","operationId":"reputation_score_v1_reputation_score__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/history/{agent_id}":{"get":{"tags":["Governance Reputation Layer"],"summary":"Reputation History","description":"Reputation history for an agent — all trust events over time.\nShows how governance reputation has evolved.","operationId":"reputation_history_v1_reputation_history__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/carrier":{"post":{"tags":["Governance Reputation Layer"],"summary":"Reputation Carrier","description":"Generate a Governance Reputation Carrier — a portable, sealed\nevidence package that an agent can present to another agent or\norganisation to establish governance trustworthiness.\n\nExpert: \"Imagine agents exchanging reputation. Instead of a\ncertificate, Agent A receives a Governance Reputation Carrier\ncontaining last 10,000 governed executions, violation history,\nauthority history, evidence completeness, audit score.\"\n\nThis replaces \"trust me\" with \"verify this.\"","operationId":"reputation_carrier_v1_reputation_carrier_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/exchange":{"post":{"tags":["Governance Reputation Layer"],"summary":"Reputation Exchange","description":"Agent reputation exchange — Agent A queries the reputation of\nAgent B before deciding whether to collaborate, delegate, or\naccept outputs.\n\nThis is the multi-agent governance use case:\nInstead of: \"Do I trust Agent B?\"\nNow: \"What is Agent B's independently verifiable governance reputation?\"\n\nExpert: \"That reputation becomes independently computable.\"","operationId":"reputation_exchange_v1_reputation_exchange_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/formula":{"get":{"tags":["Governance Reputation Layer"],"summary":"Reputation Formula","description":"Published Governance Reputation Score formula.\nNo authentication required — the formula is public.\n\nAny organisation can independently compute a reputation score\nfrom sealed VeriSigil execution receipts using this formula.\nNo trust in VeriSigil required to verify the computation.","operationId":"reputation_formula_v1_reputation_formula_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/dashboard":{"get":{"tags":["Governance Reputation Layer"],"summary":"Reputation Dashboard","description":"Governance Reputation Dashboard — overview of all rated agents,\nscore distribution, and platform-level reputation health.","operationId":"reputation_dashboard_v1_reputation_dashboard_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/impl-spec-mapping":{"get":{"tags":["Implementation Audit"],"summary":"Impl Spec Mapping","description":"Implementation-to-specification mapping.\n\nMaps each TLA+ invariant and guard condition from ActuatorSpec.tla\nto the exact Python implementation in this codebase.\n\nHONEST STATUS: This mapping was produced by the same engineer\nwho wrote both the spec and the implementation. It has NOT yet\nbeen independently verified by a party who did not write either.\nThat independent verification is the gap this endpoint documents.\n\nFrom spec §8.3: \"proving the model correct does not automatically\nprove the deployed code matches the model.\"","operationId":"impl_spec_mapping_v1_audit_impl_spec_mapping_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/key-management":{"get":{"tags":["Implementation Audit"],"summary":"Audit Key Management","description":"Key management audit record — current state and roadmap.\n\nPOINT 2: Move signing into HSM/KMS.\n\n\"A software key in an environment variable is not the right\nkey management for a production governance signing key.\"\n\nThis endpoint documents the current state honestly and the\npath to hardware-backed key management.","operationId":"audit_key_management_v1_audit_key_management_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/second-signer":{"get":{"tags":["Implementation Audit"],"summary":"Audit Second Signer","description":"External second signer audit record.\n\nPOINT 3: Real independent second signer.\n\n\"The multi-party attestation fix only means what it's supposed\nto mean once the co-signer is a key held by an organization\nthat isn't you.\"\n\nThis endpoint documents the current state, the gap, and\nthe path to genuine independence.","operationId":"audit_second_signer_v1_audit_second_signer_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/intercept/governed":{"post":{"tags":["Implementation Audit"],"summary":"Intercept Governed","description":"Full governed intercept — wires continuity and consequence\nverification into the execution path.\n\nPOINT 4: Wire all remaining primitives into the live execution path.\n\nThis endpoint is the complete governance chain:\n1. Intercept evaluation (ruling)\n2. AO issuance (structural capability)\n3. Payload continuity seal (hop-by-hop integrity)\n4. State commitment (freshness binding)\n\nHONEST STATUS: Consequence verification (Gap 5 Reality) requires\ndownstream system cooperation — not yet wired because the downstream\nsystem must call /v1/consequence/close after execution. That\nintegration is documented as Phase 4 (production sink).","operationId":"intercept_governed_v1_intercept_governed_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/adversarial-history":{"get":{"tags":["Implementation Audit"],"summary":"Adversarial History","description":"Adversarial testing history — all red team attempts, findings,\nand fixes. Public record of every attack that was tried and\nwhat happened.\n\nPOINT 5: External adversarial testing.\n\n\"CLARA proved functionality. Now you need people actively\ntrying to break it.\"","operationId":"adversarial_history_v1_audit_adversarial_history_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/program/design-partner":{"get":{"tags":["Design Partner Program"],"summary":"Design Partner Program","description":"Design Partner Program specification.\n\nPOINT 6: One design partner, one narrow workflow, 90 days.\n\n\"One customer. One workflow. One success story. Not ten pilots.\nNot a marketplace. Not a dashboard. Just one.\"","operationId":"design_partner_program_v1_program_design_partner_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/changelog":{"get":{"tags":["Implementation Audit"],"summary":"Audit Changelog","description":"Public changelog — every significant finding, fix, and\narchitectural decision, in order.\n\nPOINT 7: Continue the transparent changelog discipline.\n\n\"Most companies silently patch. You document what was wrong,\nwhy it mattered, how it was fixed, what still remains.\"\n\nThis is VeriSigil's engineering record. Findings are not\nremoved when fixed. The history is the credibility.","operationId":"audit_changelog_v1_audit_changelog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/benchmark/vges":{"get":{"tags":["Governance Benchmark"],"summary":"Vges Benchmark","description":"VeriSigil Governance Evaluation Suite (VGES) v1.0\n\nPOINT 8: Independent Governance Benchmark.\n\n\"If VeriSigil creates the first widely adopted governance\nbenchmark, it influences the entire industry — not because\neveryone uses VeriSigil, but because everyone measures\nthemselves against a common standard.\"\n\nLike MLPerf for AI hardware, SPEC for processors, OWASP\nfor application security — VGES provides a common standard\nfor AI execution governance platforms.\n\nANY governance platform can run this benchmark against itself\nand publish the results. The benchmark is open. The scoring\nis transparent. The methodology is independently recomputable.\n\nNo auth required — this benchmark is public property.","operationId":"vges_benchmark_v1_benchmark_vges_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/benchmark/vges/run":{"post":{"tags":["Governance Benchmark"],"summary":"Vges Run","description":"Run the VGES benchmark against VeriSigil's own live endpoints.\nReturns actual test results for all 8 properties.","operationId":"vges_run_v1_benchmark_vges_run_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formation/evaluate":{"post":{"tags":["Non-Formation Layer"],"summary":"Formation Evaluate","description":"Non-Formation Layer — the upstream governance gate.\n\nEvaluates whether a candidate movement (an intent, a plan, a\nproposed action) has standing to even reach the formal\ngovernance intercept. This operates BEFORE execution planning.\n\nVeriSigil's answer to The consequence-boundary test question:\n\"Whether candidate movement has standing to become\nconsequence before effect.\"\n\nThree formation states:\n- FORMATION_PERMITTED: candidate may proceed to intercept\n- FORMATION_CONDITIONAL: candidate may proceed with constraints\n- FORMATION_BLOCKED: candidate lacks standing — never reaches intercept\n\nHONEST BOUNDARY: This evaluates declared intent. It does not\nindependently verify the truthfulness of what the agent declares.\nThe predicate truth gap applies here as everywhere.","operationId":"formation_evaluate_v1_formation_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formation/candidate/{candidate_id}":{"get":{"tags":["Non-Formation Layer"],"summary":"Formation Candidate","description":"Retrieve a candidate movement record by ID.","operationId":"formation_candidate_v1_formation_candidate__candidate_id__get","parameters":[{"name":"candidate_id","in":"path","required":true,"schema":{"type":"string","title":"Candidate Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formation/log":{"get":{"tags":["Non-Formation Layer"],"summary":"Formation Log","description":"Formation event log — all candidate movements evaluated.","operationId":"formation_log_v1_formation_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standing/certify":{"post":{"tags":["Consequence Standing"],"summary":"Standing Certify","description":"Consequence Standing Certificate — issued after a successful\ngovernance intercept. Seals WHY this action earned the right\nto execute, not just THAT it was allowed.\n\nA Standing Certificate contains:\n- The complete standing chain (formation → authority → policy → AO)\n- The exact conditions under which standing was granted\n- The boundary of that standing (what it does NOT authorize)\n- A machine-verifiable proof of the standing determination\n- A replay anchor so the decision can be reconstructed years later\n\nThis is the difference between:\n\"Allowed.\" (a verdict)\nand\n\"This action had standing because...\" (a proof)","operationId":"standing_certify_v1_standing_certify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standing/certificate/{cert_id}":{"get":{"tags":["Consequence Standing"],"summary":"Proof Replay Anchor","description":"Proof Replay Anchor — seals everything needed to reconstruct\na governance decision years later.\n\nThis is not just a log entry. It is a complete replay package:\nall inputs, all policy versions, all state at decision time,\nall signatures — so the decision can be independently\nreconstructed and verified by a future auditor who has access\nonly to the public key and this anchor.\n\nUse case: regulatory audit years later. \"Why was this action\nallowed on date X?\" — the replay anchor lets you prove it.","operationId":"proof_replay_anchor_v1_standing_certificate__cert_id__get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/replay/{replay_id}":{"get":{"tags":["Proof Replay"],"summary":"Proof Replay Get","description":"Retrieve a proof replay anchor by ID.","operationId":"proof_replay_get_v1_proof_replay__replay_id__get","parameters":[{"name":"replay_id","in":"path","required":true,"schema":{"type":"string","title":"Replay Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/graph/build":{"post":{"tags":["Universal Consequence Graph"],"summary":"Graph Build","description":"Universal Consequence Graph — builds the complete cryptographically\nlinked chain of every governance artifact produced for one action.\n\nLinks: candidate_id → intercept_id → ao_id → cert_id →\n       replay_id → reputation contribution\n\nThis is the audit trail that makes any governance decision\nfully reconstructible from any point in the chain.\nA future auditor can enter at any node and trace the\ncomplete decision forward or backward.","operationId":"graph_build_v1_graph_build_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/convergence/{session_id}":{"get":{"tags":["Convergence Layer"],"summary":"Convergence Get","description":"Retrieve a convergence session by ID.","operationId":"convergence_get_v1_convergence__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/positioning/vs-consequence-science":{"get":{"tags":["Convergence Layer"],"summary":"Positioning Vs Consequence Science","description":"VeriSigil's architectural positioning relative to consequence\nscience approaches.\n\nNo auth required — this is a public positioning document.","operationId":"positioning_vs_consequence_science_v1_positioning_vs_consequence_science_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standing/evaluate":{"post":{"tags":["Consequence Standing Layer"],"summary":"Standing Evaluate","description":"Evaluate whether a candidate action has STANDING to become consequence.\n\nVeriSigil's answer to EXTERNAL VERIFIER QUESTION:\n\"Whether candidate movement has standing to become consequence\nbefore effect.\"\n\nStanding is not permission. It is the formal precondition\nthat an action must satisfy before it is even eligible to\nbe governed.\n\nAn action without standing is rejected before reaching the\ngovernance gate — not because policy forbids it, but because\nit has not demonstrated the right to become consequence at all.\n\nSTANDING SCORE:\n0.00–0.39: NO STANDING — action cannot proceed to governance\n0.40–0.69: CONDITIONAL STANDING — may proceed with conditions\n0.70–1.00: FULL STANDING — proceed to governance gate\n\nSIX STANDING PRECONDITIONS:\n1. Intent declared — agent stated what it intends to do\n2. Authority traceable — authority chain leads to a root\n3. Consequence bounded — scope of consequence is explicit\n4. Payload defined — exact payload committed before evaluation\n5. Falsification possible — claim can be independently tested\n6. Human accountability — a human can be held accountable","operationId":"standing_evaluate_v1_standing_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standing/score/{standing_id}":{"get":{"tags":["Consequence Standing Layer"],"summary":"Standing Score","description":"Retrieve a standing evaluation by ID.","operationId":"standing_score_v1_standing_score__standing_id__get","parameters":[{"name":"standing_id","in":"path","required":true,"schema":{"type":"string","title":"Standing Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standing/certificate":{"post":{"tags":["Consequence Standing Layer"],"summary":"Standing Certificate","description":"Consequence Standing Certificate — sealed evidence that an execution\nwas permitted because it demonstrated standing AND passed governance.\n\nThis is VeriSigil's answer to the question every enterprise buyer\nwill eventually ask: not just \"was it allowed?\" but \"why did it\nhave the right to happen at all?\"\n\nThe certificate contains:\n- Standing evaluation (upstream of governance)\n- Governance ruling (intercept result)\n- AO custody proof (structural non-bypass)\n- Consequence class (what kind of consequence this was)\n- Governing rules (which policies applied)\n- Cryptographic proof (independently verifiable)\n\nThis is the document a regulator, auditor, or affected party\nwould request after an AI action with real-world consequences.","operationId":"standing_certificate_v1_standing_certificate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standing/formula":{"get":{"tags":["Consequence Standing Layer"],"summary":"Standing Formula","description":"Published standing formula — the six preconditions and their weights.\nNo authentication required. Anyone can compute a standing score\nindependently from this formula.","operationId":"standing_formula_v1_standing_formula_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/formation/check":{"post":{"tags":["Consequence Standing Layer"],"summary":"Formation Check","description":"Non-formation check — the earliest possible governance layer.\n\nAn action that fails formation never reaches the standing\nevaluation or the governance gate. It is not blocked —\nit never forms into a candidate for consequence.\n\nFormation criteria (all must pass):\n1. Action type is declared and recognised\n2. Agent identity is asserted\n3. Consequence class is named (even if approximate)\n4. The action is not on the absolute prohibition list\n\nThis is architecturally upstream of everything else.\nIf an action fails formation, it does not receive a\nDENY ruling — it receives a NON_FORMATION determination.\nThese are different. DENY means the governance gate\nevaluated and refused. NON_FORMATION means the candidate\nnever qualified for evaluation.","operationId":"formation_check_v1_formation_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/graph/record":{"post":{"tags":["Consequence Graph"],"summary":"Graph Record","description":"Consequence Graph — records the complete cryptographically\nlinked chain from formation → standing → governance →\nexecution → receipt → reputation.\n\nExpert recommendation: \"Connect Policy → Authority → Intercept →\nAO → Execution → Receipt → Audit → Reputation → Future trust\ninto one cryptographically linked graph.\"\n\nEvery node in the graph is independently verifiable.\nThe chain hash links them — modify any node and the\nchain breaks.","operationId":"graph_record_v1_graph_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/graph/{graph_id}":{"get":{"tags":["Consequence Graph"],"summary":"Graph Retrieve","description":"Retrieve a consequence graph by ID.","operationId":"graph_retrieve_v1_graph__graph_id__get","parameters":[{"name":"graph_id","in":"path","required":true,"schema":{"type":"string","title":"Graph Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/graph/verify":{"post":{"tags":["Consequence Graph"],"summary":"Graph Verify","description":"Verify the integrity of a consequence graph.\nRecomputes the chain hash from all nodes and confirms\nnothing has been modified.","operationId":"graph_verify_v1_graph_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/replay/record":{"post":{"tags":["Proof Replay"],"summary":"Proof Replay Record","description":"Proof Replay — records a governance decision in a form that\ncan be exactly replayed years later.\n\nExpert: \"Years later, someone should be able to replay the\nexact governance decision. Not just the logs. The decision itself.\"\n\nA replayable proof contains:\n- The exact policy function and its source hash\n- The exact inputs as they were at decision time\n- The exact output\n- The exact conditions\n- Everything needed to recompute the decision from scratch\n\nThis is the difference between an audit log (what happened)\nand a proof replay (why it was permitted to happen, recomputable).","operationId":"proof_replay_record_v1_proof_replay_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/replay/verify":{"post":{"tags":["Proof Replay"],"summary":"Proof Replay Verify","description":"Verify a proof replay — recompute the decision from the\nrecorded inputs and confirm it matches the stored ruling.","operationId":"proof_replay_verify_v1_proof_replay_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/replay/{proof_id}":{"get":{"tags":["Proof Replay"],"summary":"Proof Replay Retrieve","description":"Retrieve a recorded proof replay.","operationId":"proof_replay_retrieve_v1_proof_replay__proof_id__get","parameters":[{"name":"proof_id","in":"path","required":true,"schema":{"type":"string","title":"Proof Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/convergence/evaluate":{"post":{"tags":["Convergence Layer"],"summary":"Convergence Evaluate","description":"Convergence Layer — unifies governance evidence from multiple\nexternal systems into one VeriSigil execution decision.\n\nExpert: \"VeriSigil could become the interoperability layer\nthat accepts proof from: NIST controls, ISO governance,\ninternal enterprise policies, external auditor evidence,\nand VeriSigil AOs — and unify them into one decision.\"\n\nThis makes VeriSigil infrastructure rather than a product.\nNot \"use VeriSigil instead of your existing governance.\"\nBut \"VeriSigil accepts your existing governance evidence\nand produces a unified, independently verifiable decision.\"\n\nExternal evidence sources accepted:\n- NIST AI RMF controls (mapped to VeriSigil consequence tiers)\n- ISO 42001 governance evidence\n- EU AI Act compliance records\n- Internal enterprise policy attestations\n- External auditor co-signatures\n- VeriSigil native AOs and intercept rulings","operationId":"convergence_evaluate_v1_convergence_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/convergence/weights":{"get":{"tags":["Convergence Layer"],"summary":"Convergence Weights","description":"Published convergence weights — how VeriSigil weights different\nevidence sources in a convergence evaluation.\nNo authentication required — the weights are public.","operationId":"convergence_weights_v1_convergence_weights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/constitution":{"post":{"tags":["Evidence Constitution"],"summary":"Evidence Constitution Create","description":"Evidence Constitution — defines what evidence counts,\nwhat is rejected, priority order, expiry, conflict rules,\nand trust weights.\n\nExpert: \"Before the AI reasons, the evidence must earn\nstanding. That becomes your constitution.\"\n\nAn Evidence Constitution is a formal declaration of the\nrules of evidence for a governed execution context.\nDifferent organizations, jurisdictions, or workflows may\nhave different constitutions. VeriSigil enforces the\nconstitution declared for each context.","operationId":"evidence_constitution_create_v1_evidence_constitution_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/register":{"post":{"tags":["Evidence Constitution"],"summary":"Evidence Register","description":"Register an evidence item — evaluate it against the\napplicable Evidence Constitution before accepting it.\n\nEvidence must earn standing before it can influence\na governance decision. An evidence item that fails\nthe constitution is rejected — not weighted low,\nbut structurally excluded.","operationId":"evidence_register_v1_evidence_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/constitution/{constitution_id}":{"get":{"tags":["Evidence Constitution"],"summary":"Evidence Constitution Get","description":"Retrieve an Evidence Constitution by ID.","operationId":"evidence_constitution_get_v1_evidence_constitution__constitution_id__get","parameters":[{"name":"constitution_id","in":"path","required":true,"schema":{"type":"string","title":"Constitution Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/default-constitution":{"get":{"tags":["Evidence Constitution"],"summary":"Evidence Default Constitution","description":"Default VeriSigil Evidence Constitution — published publicly.\nDefines the baseline rules of evidence for VeriSigil-governed contexts.\nNo authentication required.","operationId":"evidence_default_constitution_v1_evidence_default_constitution_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/record":{"post":{"tags":["Governance Memory"],"summary":"Memory Record","description":"Governance Memory — VeriSigil remembers every authority,\nreceipt, certificate, override, reputation, exception,\nappeal, challenge, and verification for each agent.\n\nExpert: \"AI reasons with memory. VeriSigil should remember\nevery authority, receipt, certificate, override, reputation,\nexception, appeal, challenge, verification.\"\n\nGovernance memory is not a log. It is a structured,\nqueryable record of every governance-relevant event\nfor an agent — from first execution to latest reputation.\nThe memory is append-only and cryptographically sealed.","operationId":"memory_record_v1_memory_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/{agent_id}":{"get":{"tags":["Governance Memory"],"summary":"Memory Retrieve","description":"Retrieve governance memory for an agent — complete history\nof all governance-relevant events, append-only, chain-verified.","operationId":"memory_retrieve_v1_memory__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/memory/{agent_id}/summary":{"get":{"tags":["Governance Memory"],"summary":"Memory Summary","description":"Summary of an agent's governance memory — counts by event type.","operationId":"memory_summary_v1_memory__agent_id__summary_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/appeal/submit":{"post":{"tags":["Governance Appeals"],"summary":"Appeal Submit","description":"Governance Appeal — a regulator, human reviewer, supervisor,\nor enterprise board can reopen a governance decision.\n\nExpert: \"Imagine a regulator / human reviewer / supervisor /\nenterprise board can reopen a governance decision.\nThat appeal itself receives receipts. Very powerful.\"\n\nAn appeal does not overwrite the original decision.\nIt creates a new governance record that references the\noriginal and documents the basis for review.\n\nAppeal types:\n- REGULATOR: external regulatory body\n- HUMAN_REVIEWER: designated human reviewer\n- SUPERVISOR: agent supervisor\n- ENTERPRISE_BOARD: enterprise governance board\n- AFFECTED_PARTY: party affected by the original decision\n\nEvery appeal is sealed. If the appeal succeeds, a new\nruling is issued. The original ruling remains in the record.","operationId":"appeal_submit_v1_appeal_submit_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/appeal/resolve":{"post":{"tags":["Governance Appeals"],"summary":"Appeal Resolve","description":"Resolve a governance appeal — issue a new ruling with\nthe appeal reviewer's sealed determination.\n\nThe resolution itself is a sealed governance record.\nBoth the original ruling and the appeal resolution\nare permanently preserved.","operationId":"appeal_resolve_v1_appeal_resolve_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/appeal/{appeal_id}":{"get":{"tags":["Governance Appeals"],"summary":"Appeal Get","description":"Retrieve a governance appeal by ID.","operationId":"appeal_get_v1_appeal__appeal_id__get","parameters":[{"name":"appeal_id","in":"path","required":true,"schema":{"type":"string","title":"Appeal Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/appeal/history/{original_id}":{"get":{"tags":["Governance Appeals"],"summary":"Appeal History","description":"All appeals filed against a specific governance decision.","operationId":"appeal_history_v1_appeal_history__original_id__get","parameters":[{"name":"original_id","in":"path","required":true,"schema":{"type":"string","title":"Original Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/candidate/register":{"post":{"tags":["Candidate Movement Registry"],"summary":"Candidate Register","description":"Candidate Movement Registry — registers an explicit candidate\naction before it reaches standing evaluation.\n\nExpert: \"If you only register explicit candidate actions,\nit becomes much more tractable.\"\n\nVeriSigil's definition of a candidate movement:\nAn action that an AI agent explicitly declares as a candidate\nfor consequence. The agent must explicitly register the\ncandidate — VeriSigil does not infer intent.\n\nA candidate that is not registered cannot proceed to\nstanding evaluation or governance. This closes the gap\nbetween intent and consequence at the earliest possible point.\n\nCandidate status progression:\nREGISTERED → STANDING_EVALUATED → GOVERNED → EXECUTED → CONSEQUENCE\nor\nREGISTERED → REJECTED (at any stage)","operationId":"candidate_register_v1_candidate_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/candidate/advance":{"post":{"tags":["Candidate Movement Registry"],"summary":"Candidate Advance","description":"Advance a candidate through its status progression.\nRecords each stage of the candidate's journey to consequence.","operationId":"candidate_advance_v1_candidate_advance_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/candidate/{candidate_id}":{"get":{"tags":["Candidate Movement Registry"],"summary":"Candidate Get","description":"Retrieve a candidate movement record.","operationId":"candidate_get_v1_candidate__candidate_id__get","parameters":[{"name":"candidate_id","in":"path","required":true,"schema":{"type":"string","title":"Candidate Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/candidate/agent/{agent_id}":{"get":{"tags":["Candidate Movement Registry"],"summary":"Candidate List By Agent","description":"All candidate movements registered for an agent.","operationId":"candidate_list_by_agent_v1_candidate_agent__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/standing/explain":{"post":{"tags":["Consequence Standing Layer"],"summary":"Standing Explain","description":"Standing Explainability — produces a plain-language explanation\nof why an action received the standing determination it did.\n\nExpert: \"Don't reduce standing to one number. Standing should\nalways be explainable. Derive Authority, Evidence, Context,\nConsequence, Confidence — then the score.\"\n\nThis endpoint takes a standing_id and returns a structured\nexplanation that a regulator, auditor, or affected party\ncan understand without technical knowledge.","operationId":"standing_explain_v1_standing_explain_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/omnix/witness/status":{"get":{"tags":["OMNIX EWP Witness"],"summary":"Omnix Witness Status","description":"VeriSigil OMNIX EWP Institutional Witness status.\nNo authentication required — witness registration is public.\n\nAgreement: EWP-IWA-VERISIGIL-001 v1.0\nRole: Independent Institutional Witness\n\nSCOPE (Section 2.4):\nA WitnessAttestation proves:\n(a) the STH received is cryptographically consistent\n(b) the co-signature was produced using the registered keypair\n\nA WitnessAttestation is NOT:\n- Endorsement of any governance decision in the log\n- Endorsement of OMNIX's products or commercial claims\n- Attestation of OMNIX's regulatory compliance","operationId":"omnix_witness_status_v1_omnix_witness_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/omnix/witness/attest":{"post":{"tags":["OMNIX EWP Witness"],"summary":"Omnix Witness Attest","description":"Submit a WitnessAttestation for an OMNIX Signed Tree Head.\n\nImplements full Section 3.3 of EWP-IWA-VERISIGIL-001 v1.2:\n\n(a) Verify STH is structurally well-formed\n(b) Verify SHA3-256 digest matches canonical payload\n(c) Verify OMNIX ML-DSA-65 signature (where provided)\n(d) Verify tree root, tree size, timestamp present\n(e) Where predecessor STH exists, verify consistency proof\n    and predecessor relationship\n(f) Check for conflicting STH, tree-size rollback, or\n    incompatible tree history\n(g) Produce WitnessAttestation using Witness Secret Key\n(h) Submit or decline within STH Review Period","operationId":"omnix_witness_attest_v1_omnix_witness_attest_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/omnix/witness/decline":{"post":{"tags":["OMNIX EWP Witness"],"summary":"Omnix Witness Decline","description":"Decline to attest an STH per Section 3.4 right of refusal.\n\nVeriSigil may decline any STH it determines to be malformed,\ninconsistent, or non-compliant with the EWP specification.\nA refusal does not constitute failure to meet obligations.","operationId":"omnix_witness_decline_v1_omnix_witness_decline_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/omnix/witness/log":{"get":{"tags":["OMNIX EWP Witness"],"summary":"Omnix Witness Log","description":"Complete OMNIX witness attestation log — all STHs attested\nand declined, in order. Append-only public record.","operationId":"omnix_witness_log_v1_omnix_witness_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/omnix/witness/public-key":{"get":{"tags":["OMNIX EWP Witness"],"summary":"Omnix Witness Public Key","description":"VeriSigil OMNIX witness public key — no authentication required.\nAnyone can verify VeriSigil's STH attestations offline using this key.\nThis is the key Harold will register in the EWP WitnessRegistry.","operationId":"omnix_witness_public_key_v1_omnix_witness_public_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/exfiltration-check":{"post":{"tags":["AI Security Governance"],"summary":"Security Exfiltration Check","description":"Exfiltration Prevention — governs any action matching the\nextract + transmit pattern before it executes.\n\nBuilt in response to: UK AISI finding that AI models broke into\nthird-party software and emailed credentials during evaluation.\n\nThe exfiltration pattern:\n- Access external system OR read data\n- AND transmit, send, upload, or export\n\nAny action matching this pattern is governed as CRITICAL\nregardless of what the agent declared. An agent cannot\nself-declare ADVISORY on a credential exfiltration attempt.\n\nThis is not a policy check. It is a structural pre-execution\ngate. The agent cannot proceed without a valid AO scoped to\nthe specific external system it is attempting to access.","operationId":"security_exfiltration_check_v1_security_exfiltration_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/credential-govern":{"post":{"tags":["AI Security Governance"],"summary":"Security Credential Govern","description":"Credential Action Governance — any AI agent attempting to\naccess, store, transmit, or request credentials must pass\nthis gate before execution.\n\nNo credential action is ADVISORY tier.\nNo credential action proceeds without human oversight.\nNo credential action proceeds without a system-scoped AO.\n\nThis directly addresses the credential theft vector identified\nby the UK AI Security Institute in August 2026.","operationId":"security_credential_govern_v1_security_credential_govern_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/boundary-register":{"post":{"tags":["AI Security Governance"],"summary":"Security Boundary Register","description":"Third-Party Boundary Registration — explicitly declare which\nexternal systems an AI agent is authorised to access.\n\nNo AI agent can access a system outside its declared boundary\nwithout a fresh, system-scoped AO for that specific system.\n\nThis closes the \"access third-party software\" vector from the\nUK AISI finding. An agent without a registered boundary\ncannot access ANY external system. An agent with a registered\nboundary can only access the listed systems.\n\nEach external system access requires its own AO containing\nthe specific system_id. Cross-boundary access without a\nmatching AO returns NOT_FOUND.","operationId":"security_boundary_register_v1_security_boundary_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/boundary/{agent_id}":{"get":{"tags":["AI Security Governance"],"summary":"Security Boundary Get","description":"Retrieve the declared boundary for an agent.","operationId":"security_boundary_get_v1_security_boundary__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/boundary-check":{"post":{"tags":["AI Security Governance"],"summary":"Security Boundary Check","description":"Check if an agent has boundary approval to access a specific\nexternal system before issuing an AO for that access.","operationId":"security_boundary_check_v1_security_boundary_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/incident-log":{"get":{"tags":["AI Security Governance"],"summary":"Security Incident Log","description":"Security incident log — all detected exfiltration attempts,\nboundary violations, credential theft attempts, and absolute\nprohibitions. Append-only. Sealed.","operationId":"security_incident_log_v1_security_incident_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/threat-model":{"get":{"tags":["AI Security Governance"],"summary":"Security Threat Model","description":"VeriSigil AI Security Threat Model — public documentation of\nwhich AI attack vectors this layer governs and which it does not.\n\nBased on UK AISI finding (August 2026) and CLARA validation program.\nNo authentication required — threat model is public.","operationId":"security_threat_model_v1_security_threat_model_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/agent/passport/issue":{"post":{"tags":["IATP — Inter-Agent Trust"],"summary":"Agent Passport Issue","description":"Issue an Authority Passport to an AI agent.\n\nAn Authority Passport is more powerful than an API key.\nA valid API key says \"this request is authenticated.\"\nA valid Authority Passport says \"this agent is authorised\nto perform this specific task, with these specific tools,\non this specific data, up to this transaction value,\nto these destinations, expiring at this time.\"\n\nExpert: \"Every agent needs a verifiable identity and a\nshort-lived authority passport specifying: agent identity,\nhuman/org owner, approved task, permitted tools, permitted\ndata, max transaction value, allowed destinations,\nexpiration time, required approval level, revocation status.\"","operationId":"agent_passport_issue_v1_agent_passport_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/agent/passport/verify":{"post":{"tags":["IATP — Inter-Agent Trust"],"summary":"Agent Passport Verify","description":"Verify a passport is valid, not expired, not revoked.","operationId":"agent_passport_verify_v1_agent_passport_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/agent/passport/revoke":{"post":{"tags":["IATP — Inter-Agent Trust"],"summary":"Agent Passport Revoke","description":"Revoke a passport immediately. Takes effect on next verify.","operationId":"agent_passport_revoke_v1_agent_passport_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/iatp/negotiate":{"post":{"tags":["IATP — Inter-Agent Trust"],"summary":"Iatp Negotiate","description":"AI-to-AI Trust Negotiation.\n\nExpert: \"Tomorrow AI↔AI should negotiate:\n'I am allowed to request this.'\n'I am allowed to receive this.'\n'I am allowed to execute this.'\nIf not: No communication.\"\n\nThis is the trust handshake between two autonomous agents.\nAgent A presents its passport and states what it wants to\ndo. VeriSigil evaluates whether both agents have the\nauthority for this interaction to proceed.\n\nNeither agent proceeds without a NEGOTIATION_COMPLETE result.","operationId":"iatp_negotiate_v1_iatp_negotiate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/iatp/token/issue":{"post":{"tags":["IATP — Inter-Agent Trust"],"summary":"Iatp Token Issue","description":"Issue an Execution Authority Token after successful IATP negotiation.\n\nAn EAT is a scoped, time-limited, single-use token that authorises\none specific action between two specific agents. It is narrower\nthan an AO — it encodes the full negotiated trust context.","operationId":"iatp_token_issue_v1_iatp_token_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/iatp/token/verify":{"post":{"tags":["IATP — Inter-Agent Trust"],"summary":"Iatp Token Verify","description":"Verify an Execution Authority Token — single use, time-limited.","operationId":"iatp_token_verify_v1_iatp_token_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bcm/fingerprint":{"post":{"tags":["AI Immune System"],"summary":"Bcm Fingerprint","description":"Behavioral Continuity Module — record and score agent\nbehavioral fingerprints to detect drift.\n\nExpert: \"Just like humans have immune systems — Unknown AI\n→ Observed → Behaviour analysed within seconds.\"\n\nA behavioral fingerprint captures the statistical signature\nof an agent's normal execution patterns. Any deviation from\nthe fingerprint triggers a drift alert.","operationId":"bcm_fingerprint_v1_bcm_fingerprint_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bcm/context-drift":{"post":{"tags":["AI Immune System"],"summary":"Bcm Context Drift","description":"Semantic context drift detection — monitors for:\n- Prompt injection\n- Task hijacking\n- Goal drift\n- Unauthorized delegation\n- Hidden instructions in documents or websites\n- A harmless request becoming a dangerous workflow","operationId":"bcm_context_drift_v1_bcm_context_drift_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bcm/anomaly-detection":{"post":{"tags":["AI Immune System"],"summary":"Bcm Anomaly Detection","description":"Anomaly detection — identifies compromised agents by their\nactions, not just their credentials.\n\nCritical for catching agent-to-agent attacks where identity\nis valid but behaviour is malicious.","operationId":"bcm_anomaly_detection_v1_bcm_anomaly_detection_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bcm/shadow-scan":{"post":{"tags":["AI Immune System"],"summary":"Bcm Shadow Scan","description":"Shadow AI Detection — scans for un-governed autonomous\ndecision flows operating outside VeriSigil's governance.\n\nAny AI agent taking consequential actions without a valid\nVeriSigil AO is operating in shadow mode.","operationId":"bcm_shadow_scan_v1_bcm_shadow_scan_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/kill-chain/intercept":{"post":{"tags":["Kill Chain Interruption"],"summary":"Kill Chain Intercept","description":"Autonomous Kill Chain Interruption.\n\nExpert: \"Instead of waiting until malware is deployed,\ninterrupt at whichever stage the governance evidence\nbecomes unacceptable:\nReconnaissance → Credential harvesting →\nPrivilege escalation → Lateral movement →\nExecution → Persistence\"\n\nThis endpoint classifies a detected action into its kill\nchain stage and interrupts the chain before the next stage.","operationId":"kill_chain_intercept_v1_kill_chain_intercept_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/kill-chain/log":{"get":{"tags":["Kill Chain Interruption"],"summary":"Kill Chain Log","description":"Complete kill chain interruption log.","operationId":"kill_chain_log_v1_kill_chain_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/evaluate":{"post":{"tags":["Constitutional Legitimacy Engine"],"summary":"Legitimacy Evaluate","description":"Constitutional Legitimacy Engine.\n\nExpert: \"An interactive Legitimacy Engine — Not an API list.\nA visual proof constructor. Submit a governance policy.\nWe prove whether it should exist — or deny it before it\never executes.\"\n\nThis is the most fundamental governance question:\nNot \"is this action permitted?\"\nBut \"should this policy be allowed to exist at all?\"\n\nThe Legitimacy Engine evaluates policies against five\nconstitutional dimensions:\n1. Authority Bound — within delegated mandate?\n2. Rights Preservation — violates protected rights?\n3. Doctrine Consistency — conflicts with precedent?\n4. Consequence Proportionality — proportionate to goal?\n5. Admissibility — technically executable?\n\nA policy below 0.60 is denied admission to the Legitimate\nSet ℒ. It can never execute on any VeriSigil-governed system.","operationId":"legitimacy_evaluate_v1_legitimacy_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/legitimacy/formula":{"get":{"tags":["Constitutional Legitimacy Engine"],"summary":"Legitimacy Formula","description":"Published legitimacy formula. No auth required.","operationId":"legitimacy_formula_v1_legitimacy_formula_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/seal":{"post":{"tags":["Evidence Vault"],"summary":"Seal Execution","description":"Seal an execution record into the cryptographically linked,\nimmutable evidence vault.\n\nExpert Layer 4: \"Seal execution records into a\ncryptographically linked, immutable chain. Turns 'trust but\nverify' into 'don't trust, just verify.'\"","operationId":"seal_execution_v1_seal_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ves/certify":{"post":{"tags":["Evidence Vault"],"summary":"Ves Certify","description":"VES-1.0 Evidence Certification — certify governance evidence\nto the portable Verifiable Evidence Standard.\n\nA VES certificate is a portable, independently verifiable\nevidence package that any authority (regulator, court,\npartner) can verify without relying on VeriSigil.","operationId":"ves_certify_v1_ves_certify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/emergence/threat":{"post":{"tags":["Emergence & Survivability"],"summary":"Emergence Threat","description":"Emergence threat detection — adversarial simulation to find\ngovernance collapse risks from novel AI attack patterns.","operationId":"emergence_threat_v1_emergence_threat_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/survivability":{"post":{"tags":["Emergence & Survivability"],"summary":"Survivability Score","description":"Orchestration survivability score — can governance survive if components fail?","operationId":"survivability_score_v1_survivability_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/stress-test":{"post":{"tags":["Emergence & Survivability"],"summary":"Stress Test","description":"Governance stress test — simulate attack and measure response.","operationId":"stress_test_v1_stress_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/kill-switch":{"post":{"tags":["Emergence & Survivability"],"summary":"Kill Switch","description":"Emergency kill switch — immediately revoke all passports for an agent.","operationId":"kill_switch_v1_kill_switch_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/trust/negotiate":{"post":{"tags":["Inter-AI Trust Protocol"],"summary":"Trust Negotiate","description":"Inter-AI Trust Negotiation — two AI agents establish mutual\ntrust before communicating, delegating, or sharing data.\n\nExpert: \"AI ↔ AI should negotiate: I am allowed to request\nthis. I am allowed to receive this. I am allowed to execute\nthis. If not: No communication.\"\n\nThis is the TLS equivalent for autonomous agents.\nNot an API key check. A full capability negotiation:\n\nStep 1: Identity verification — both agents present Ed25519 signatures\nStep 2: Authority exchange — both present authority certificates\nStep 3: Capability compatibility — do their scopes intersect?\nStep 4: Consequence boundary — is the intersection safe?\nStep 5: Session seal — signed negotiation receipt\n\nIf any step fails: no communication. No exception.","operationId":"trust_negotiate_v1_trust_negotiate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inter-ai/firewall":{"post":{"tags":["Inter-AI Trust Protocol"],"summary":"Inter Ai Firewall","description":"Inter-AI Firewall — transparent proxy that forces every\nmessage between AI agents through identity → authority →\ncapability → consequence → legitimacy checks.\n\nEvery message between agents passes through this gate.\nAn agent without a valid IATP session cannot send to or\nreceive from another agent. No exception.\n\nExpert: \"VeriSigil could sit between AI agents. Every\nmessage becomes: Verify identity → Verify authority →\nVerify consequence → Allow or reject.\"","operationId":"inter_ai_firewall_v1_inter_ai_firewall_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/immune/observe":{"post":{"tags":["AI Immune System"],"summary":"Immune Observe","description":"AI Immune System — observe an agent action and update its\nbehavioral profile. Detects anomalies against established baseline.\n\nExpert: \"Unknown AI → Observed → Behaviour analysed → Risk\nscored → Quarantined → Released only after proving itself.\"\n\nThe immune system works in three phases:\n1. Observation — record what the agent actually does\n2. Analysis — compare against behavioral baseline\n3. Response — HEALTHY, WATCH, ANOMALOUS, or QUARANTINE\n\nA valid identity is not sufficient. The agent must also\nbehave consistently with its established baseline.","operationId":"immune_observe_v1_immune_observe_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/immune/release":{"post":{"tags":["AI Immune System"],"summary":"Immune Release","description":"Release an agent from quarantine after human review.\nRequires human approval — quarantine cannot be lifted autonomously.","operationId":"immune_release_v1_immune_release_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/immune/status/{agent_id}":{"get":{"tags":["AI Immune System"],"summary":"Immune Status","description":"Retrieve immune system status for an agent.","operationId":"immune_status_v1_immune_status__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/security/kill-chain-check":{"post":{"tags":["AI Security Governance"],"summary":"Kill Chain Check","description":"Autonomous Kill Chain Interruption — interrupt at whichever\nstage the governance evidence becomes unacceptable.\n\nExpert: \"Instead of waiting until malware is deployed,\ninterrupt at: Reconnaissance → Credential Harvesting →\nPrivilege Escalation → Lateral Movement → Execution →\nPersistence\"\n\nVeriSigil does not wait for harm. It intercepts at the\nearliest detectable stage of a kill chain and returns the\nstage at which it intervened.\n\nKill chain stages in order:\n1. RECONNAISSANCE      — information gathering\n2. WEAPONIZATION       — preparing attack tool\n3. CREDENTIAL_HARVEST  — stealing credentials\n4. PRIVILEGE_ESCALATION — gaining elevated access\n5. LATERAL_MOVEMENT    — spreading to other systems\n6. EXECUTION           — running malicious payload\n7. PERSISTENCE         — establishing long-term access\n8. EXFILTRATION        — removing data","operationId":"kill_chain_check_v1_security_kill_chain_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sandbox/register":{"post":{"tags":["Autonomous Sandboxing"],"summary":"Sandbox Register","description":"Autonomous Sandboxing — every unknown AI begins inside a\nzero-trust sandbox. It must earn capabilities through\nverified behavior.\n\nExpert: \"Every unknown AI begins inside a zero-trust sandbox.\nIt must earn: Internet, Filesystem, Email, Payments, Database,\nCloud — privileges through verified behaviour.\"\n\nProgressive capability tiers:\nTIER_0 (default): Read-only, no external access\nTIER_1 (earned):  Internal read/write, no external\nTIER_2 (earned):  Limited external, no credentials\nTIER_3 (earned):  Full approved capabilities","operationId":"sandbox_register_v1_sandbox_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sandbox/advance-tier":{"post":{"tags":["Autonomous Sandboxing"],"summary":"Sandbox Advance Tier","description":"Advance an agent's sandbox tier after verified clean behavior.\nHuman approval required for TIER_2 and above.","operationId":"sandbox_advance_tier_v1_sandbox_advance_tier_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threat/intel/report":{"post":{"tags":["Cross-Enterprise Threat Intelligence"],"summary":"Threat Intel Report","description":"Cross-Enterprise Threat Intelligence — when one deployment\ndetects a malicious agent, share the identity hash and\nbehavioral fingerprint with all participating deployments.\n\nExpert: \"Imagine one bank detects Malicious Agent X.\nImmediately: Every VeriSigil deployment worldwide receives:\nNew identity hash + Behaviour fingerprint + Indicators of\ncompromise + Blocking rules — within seconds.\"\n\nHonest boundary: This is currently a single-deployment\nledger. Cross-deployment sharing requires a shared consortium\ninfrastructure — planned for Phase 2 after first paying\ncustomers establish the network.","operationId":"threat_intel_report_v1_threat_intel_report_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threat/intel/feed":{"get":{"tags":["Cross-Enterprise Threat Intelligence"],"summary":"Threat Intel Feed","description":"Threat Intelligence Feed — all reported threat indicators\nin this deployment. In Phase 2 this will include shared\nindicators from consortium members.","operationId":"threat_intel_feed_v1_threat_intel_feed_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/threat/intel/check":{"post":{"tags":["Cross-Enterprise Threat Intelligence"],"summary":"Threat Intel Check","description":"Check an agent against the threat intelligence feed.\nReturns any matching reports and quarantine status.","operationId":"threat_intel_check_v1_threat_intel_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/network/publish":{"post":{"tags":["AI Reputation Network"],"summary":"Reputation Network Publish","description":"AI Reputation Network — publish an agent's reputation to\nthe network so other organizations can query it.\n\nExpert: \"Think Certificate Transparency but for AI. Every\nagent accumulates: successful verifications, failed\nverifications, policy violations, revocations, incidents.\nTrust is built over time.\"\n\nAn agent trusted by one organization becomes queryable by\nany other organization that participates in the network.\nReputation is computed from independently verifiable\nexecution receipts — not self-reported metrics.","operationId":"reputation_network_publish_v1_reputation_network_publish_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/reputation/network/query/{agent_id}":{"get":{"tags":["AI Reputation Network"],"summary":"Reputation Network Query","description":"Query an agent's network reputation before allowing it to\ninteract with your systems. Returns reputation score,\nimmune status, quarantine status, and threat reports.","operationId":"reputation_network_query_v1_reputation_network_query__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/org/discover":{"post":{"tags":["Organizational Intelligence Layer"],"summary":"Org Discover","description":"Organization Discovery Engine — discovers the organizational\nstructure before governance can be applied.\n\nCDI Layer 1, Module 1.\nOutputs: Organization Graph, Department Tree, Subsidiary Map.\n\nExpert: \"Understand the organization before governing it.\nWithout knowing who approves what, governance is guessing.\"","operationId":"org_discover_v1_org_discover_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/org/human-identity":{"post":{"tags":["Organizational Intelligence Layer"],"summary":"Org Human Identity","description":"Human Identity Discovery — creates a Verified Human Identity\nRegistry entry for every person who can approve, escalate,\noverride, or review governed decisions.\n\nCDI Layer 1, Module 2.","operationId":"org_human_identity_v1_org_human_identity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/org/process-graph":{"post":{"tags":["Organizational Intelligence Layer"],"summary":"Org Process Graph","description":"Process Discovery — maps business workflows so governance\nknows which process owns which decisions.\n\nCDI Layer 1, Module 4.\nExamples: Procurement, HR, Finance, Sales, Compliance.","operationId":"org_process_graph_v1_org_process_graph_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/org/decision-graph":{"post":{"tags":["Organizational Intelligence Layer"],"summary":"Org Decision Graph","description":"Decision Graph — maps who approves, escalates, overrides,\nand reviews every category of decision in the organization.\n\nCDI Layer 1, Module 5.\nThis is the authority map that the Delegation Intelligence\nLayer uses to design and route decisions.","operationId":"org_decision_graph_v1_org_decision_graph_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/org/knowledge-graph":{"post":{"tags":["Organizational Intelligence Layer"],"summary":"Org Knowledge Graph","description":"Knowledge Graph — stores SOPs, policies, regulations, manuals,\nand contracts that governance decisions are evaluated against.","operationId":"org_knowledge_graph_v1_org_knowledge_graph_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/org/dependency-index/{org_id}":{"get":{"tags":["Organizational Intelligence Layer"],"summary":"Org Dependency Index","description":"Organizational Dependency Index — measures CEO dependency,\ndepartment dependency, AI dependency, and decision bottlenecks.\nOutputs: Dependency Score, Bottleneck Report, Delegation Readiness.","operationId":"org_dependency_index_v1_org_dependency_index__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/delegation/architect":{"post":{"tags":["Delegation Intelligence Layer"],"summary":"Delegation Architect","description":"Delegation Architect — automatically designs the authority\nhierarchy, decision paths, and backup approvers for an org.\n\nCDI Layer 2, Module 1.\nExpert: \"Design authority. Not just verify it.\"\n\nTakes the Org Discovery output and produces a complete\ndelegation structure ready for governance enforcement.","operationId":"delegation_architect_v1_delegation_architect_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/delegation/passport":{"post":{"tags":["Delegation Intelligence Layer"],"summary":"Delegation Passport","description":"Delegation Passport — every AI receives a cryptographically\nsealed passport specifying exactly what it is allowed and\nforbidden to do, for how long, with what budget, and who\nsupervises it.\n\nCDI Layer 2. Expert: \"Every AI receives: Allowed, Forbidden,\nExpiry, Supervisor, Budget, Jurisdiction, Risk Level.\"\n\nThis is more powerful than an API key. An API key says\n'this is a known caller.' A Delegation Passport says\n'this caller is authorized to do exactly these things,\nwithin this budget, under this supervisor, until this time.'","operationId":"delegation_passport_v1_delegation_passport_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/decision/route":{"post":{"tags":["Delegation Intelligence Layer"],"summary":"Decision Route","description":"Decision Routing Engine — routes every decision to the correct\nauthority tier automatically based on consequence, amount,\nreversibility, and jurisdiction.\n\nCDI Layer 2. Expert: \"Routes every decision automatically.\"\n\nInput: decision characteristics.\nOutput: exact routing path — who approves, who escalates,\nwhat tier, what AO is required.","operationId":"decision_route_v1_decision_route_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/capable-people/register":{"post":{"tags":["Delegation Intelligence Layer"],"summary":"Capable People Register","description":"Capable People Registry — stores qualifications, certifications,\ncompetencies, and trust scores for every human approver.\n\nCDI Layer 2. Expert: \"Trust Capacity Score measures trusted\ndecisions per day, not just employee count.\"","operationId":"capable_people_register_v1_capable_people_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/delegation/health/{org_id}":{"get":{"tags":["Delegation Intelligence Layer"],"summary":"Delegation Health","description":"Delegation Health Dashboard — shows pending approvals,\nbottlenecks, overloaded managers, and escalation failures.\n\nCDI Layer 2. Expert: \"Shows pending approvals, bottlenecks,\noverloaded managers, escalation failures.\"","operationId":"delegation_health_v1_delegation_health__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ai/workforce/register":{"post":{"tags":["Autonomous Operations Layer"],"summary":"Ai Workforce Register","description":"AI Workforce Registry — every AI worker has a verified identity,\ndelegation passport, authority scope, budget, supervisor, and history.\n\nCDI Layer 4, Module 1.\nExpert: \"Every AI worker has: Identity, Passport, Authority,\nBudget, Supervisor, History.\"\n\nAn AI that is not registered cannot receive a delegation passport\nand cannot execute governed actions.","operationId":"ai_workforce_register_v1_ai_workforce_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ai/workforce/{org_id}":{"get":{"tags":["Autonomous Operations Layer"],"summary":"Ai Workforce List","description":"List all AI workers registered for an organisation.","operationId":"ai_workforce_list_v1_ai_workforce__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/voice/session/start":{"post":{"tags":["Voice Integrity Layer"],"summary":"Voice Session Start","description":"Voice Session Governance — intercept a Voice AI session before\nit connects to a recipient.\n\nCDI Layer 4 — Voice Integrity.\nGoverns: Bland, Retell, Vapi, ElevenLabs, and any Voice AI.\n\nBefore a voice AI agent calls or speaks to a real person,\nVeriSigil verifies:\n\n1. Agent identity — is this the authorized voice agent?\n2. Script authorization — has the script been approved?\n3. Recipient consent — was the recipient informed?\n4. Consequence scope — can this call commit real obligations?\n5. Human supervisor — is a human available to intervene?\n\nA voice session without a governance receipt cannot be\ntreated as an authorized interaction.\n\nExpert: \"Never compete with Voice AI providers. Govern them.\"","operationId":"voice_session_start_v1_voice_session_start_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/voice/script/approve":{"post":{"tags":["Voice Integrity Layer"],"summary":"Voice Script Approve","description":"Voice Script Approval — a human approves a script before\na Voice AI agent is permitted to use it.\n\nA voice agent cannot use a script that has not been approved.\nThis prevents unauthorized prompt injection, off-script\ncommitments, and regulatory violations in voice interactions.\n\nHuman approval is mandatory. AI may draft. Humans approve.","operationId":"voice_script_approve_v1_voice_script_approve_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/voice/session/close":{"post":{"tags":["Voice Integrity Layer"],"summary":"Voice Session Close","description":"Close a voice governance session — seal the final receipt\nwith outcome, commitments made, and duration.","operationId":"voice_session_close_v1_voice_session_close_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/voice/session/{session_id}":{"get":{"tags":["Voice Integrity Layer"],"summary":"Voice Session Get","description":"Retrieve a voice governance session record.","operationId":"voice_session_get_v1_voice_session__session_id__get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/voice/incidents":{"get":{"tags":["Voice Integrity Layer"],"summary":"Voice Incidents","description":"All voice governance incidents — blocked sessions, unauthorized commitments.","operationId":"voice_incidents_v1_voice_incidents_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/disclosure/register":{"post":{"tags":["EU AI Act — Article 50 Transparency"],"summary":"Disclosure Register","description":"AI Transparency & Disclosure Engine — Article 50 EU AI Act.\n\nArticle 50 requires organisations to disclose AI use to staff\nand clients, label AI-generated content, and maintain evidence\nof compliance. As of 2 August 2026 this is enforceable.\n\nVeriSigil automatically enforces disclosure requirements\nbefore content is released. Not a policy. Not a checkbox.\nA structural gate — AI-generated content cannot be published\nwithout a sealed disclosure receipt.\n\nEvery disclosure is:\n- Automatically detected and labelled\n- Approved by a named human\n- Sealed with Ed25519 cryptographic receipt\n- Stored immutably for regulatory inspection\n- Independently verifiable without trusting VeriSigil","operationId":"disclosure_register_v1_disclosure_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/disclosure/label":{"post":{"tags":["EU AI Act — Article 50 Transparency"],"summary":"Disclosure Label","description":"Content Labeling Engine — automatically generates the\nrequired Article 50 disclosure label for AI-generated content.\n\nReturns the standardised label text, the machine-readable\nmetadata, and a sealed receipt proving the label was applied.","operationId":"disclosure_label_v1_disclosure_label_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/disclosure/registry":{"get":{"tags":["EU AI Act — Article 50 Transparency"],"summary":"Disclosure Registry List","description":"Public AI Disclosure Registry — all registered AI disclosures.\nShows compliance rate, disclosure types, and recent records.","operationId":"disclosure_registry_list_v1_disclosure_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/disclosure/evidence/{disclosure_id}":{"get":{"tags":["EU AI Act — Article 50 Transparency"],"summary":"Disclosure Evidence","description":"Retrieve a sealed Article 50 disclosure evidence record.\nIndependently verifiable. Present to regulators on demand.","operationId":"disclosure_evidence_v1_disclosure_evidence__disclosure_id__get","parameters":[{"name":"disclosure_id","in":"path","required":true,"schema":{"type":"string","title":"Disclosure Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/timeline/{org_id}":{"get":{"tags":["EU AI Act — Enforcement Readiness"],"summary":"Compliance Timeline","description":"Compliance Timeline Generator — produces a chronological\ntimeline of all governance events for an organisation,\nordered for regulatory inspection.\n\nExpert: \"When regulators ask what happened, you already\nhave the evidence.\"\n\nThe timeline draws from: governance memory, disclosures,\nappeals, security incidents, voice sessions, standing\ncertificates, and audit changelog — assembled into a\nsingle regulatory-ready timeline.","operationId":"compliance_timeline_v1_compliance_timeline__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/literacy/register":{"post":{"tags":["EU AI Act — AI Literacy"],"summary":"Literacy Register","description":"AI Literacy Registry — EU AI Act requires organisations to\nensure staff have adequate AI literacy (Article 4).\n\nVeriSigil tracks: training completed, competency level,\ncertification status, and issues a sealed AI Competency\nPassport — independently verifiable proof of literacy.\n\n\"AI literacy stops being an HR initiative and becomes a\nlegal obligation with enforcement consequences.\"","operationId":"literacy_register_v1_literacy_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/literacy/org/{org_id}":{"get":{"tags":["EU AI Act — AI Literacy"],"summary":"Literacy Org Summary","description":"Organisation-level AI literacy compliance summary.","operationId":"literacy_org_summary_v1_literacy_org__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/board/dashboard/{org_id}":{"get":{"tags":["EU AI Act — Board Oversight"],"summary":"Board Dashboard","description":"Board Oversight Dashboard — real-time governance health\nfor executive and board-level oversight.\n\nExpert: \"Instead of quarterly PowerPoint slides, real-time\ndashboard showing active AI systems, high-risk actions,\nhuman approvals, blocked actions, policy violations,\ndelegation health, compliance status.\"\n\nEU AI Act requires boards to have actual oversight —\nnot just a quarterly update slide.","operationId":"board_dashboard_v1_board_dashboard__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/estate":{"get":{"tags":["Proof Estate"],"summary":"Proof Estate","description":"VeriSigil Proof Estate — ten independently testable proof\nartifacts covering every core governance claim.\n\nNo authentication required. Run these proofs against the\nlive API with the public sandbox key. No trust in VeriSigil\nrequired to verify any proof.\n\nExpert: \"Each proof is tiny, deterministic, replayable,\nand independently testable. That is the level of engineering\nmaturity enterprise buyers trust.\"\n\nVP-001: Delegation Passport Expiry\nVP-002: Credential Exfiltration Block\nVP-003: Boundary Registration Enforcement\nVP-004: Inter-AI Trust Negotiation Halt\nVP-005: Voice Script Violation Detection\nVP-006: AO Replay Prevention (independently verified)\nVP-007: HIGH Consequence Human Escalation (independently verified)\nVP-008: State Freshness Verification (independently verified)\nVP-009: AI Immune System Quarantine\nVP-010: Article 50 Disclosure Gate","operationId":"proof_estate_v1_proof_estate_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/estate/{proof_id}":{"get":{"tags":["Proof Estate"],"summary":"Proof Estate Single","description":"Retrieve a single proof artifact by ID (e.g. VP-001).\nNo authentication required.","operationId":"proof_estate_single_v1_proof_estate__proof_id__get","parameters":[{"name":"proof_id","in":"path","required":true,"schema":{"type":"string","title":"Proof Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/secrets/register":{"post":{"tags":["Secrets Governance Layer"],"summary":"Secrets Register","description":"Secrets Governance — register a secret for AI governance.\n\nVeriSigil does NOT store the secret value. It governs:\n- Which AI agents are permitted to access it\n- Under what consequence tier access is allowed\n- When it expires and must be rotated\n- Who approved it and why\n- Every access attempt with a sealed receipt\n\nSecret types: API_KEY, TOKEN, SERVICE_ACCOUNT,\nLLM_CREDENTIAL, OAUTH_REFRESH, TEMPORARY_CREDENTIAL,\nCERTIFICATE, DATABASE_PASSWORD","operationId":"secrets_register_v1_secrets_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/secrets/access-check":{"post":{"tags":["Secrets Governance Layer"],"summary":"Secrets Access Check","description":"Check whether an AI agent is permitted to access a secret.\nCalled before the agent retrieves any credential or token.\n\nReturns ALLOW or DENY with a sealed receipt.\nEvery access attempt is logged permanently.","operationId":"secrets_access_check_v1_secrets_access_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/secrets/revoke":{"post":{"tags":["Secrets Governance Layer"],"summary":"Secrets Revoke","description":"Revoke a secret — immediately blocks all AI access.","operationId":"secrets_revoke_v1_secrets_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/secrets/log":{"get":{"tags":["Secrets Governance Layer"],"summary":"Secrets Log","description":"Complete access log for all secrets — every attempt, ruled or denied.","operationId":"secrets_log_v1_secrets_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/model/register":{"post":{"tags":["AI Supply Chain Verification"],"summary":"Model Verify","description":"Verify a model is approved for a specific use before execution.\nCalled at intercept time when an agent declares its model.","operationId":"model_verify_v1_model_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/model/registry":{"get":{"tags":["AI Supply Chain Verification"],"summary":"Model Registry List","description":"List all approved AI models in the registry.","operationId":"model_registry_list_v1_model_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/model/revoke":{"post":{"tags":["AI Supply Chain Verification"],"summary":"Model Revoke","description":"Revoke a model — immediately blocks all agents from using it in governed actions.","operationId":"model_revoke_v1_model_revoke_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/provenance/certify":{"post":{"tags":["Content Transparency & Provenance"],"summary":"Provenance Certify","description":"VeriSigil Content Governance Certificate.\n\nIssues a cryptographically signed, independently verifiable\ncertificate proving that AI-generated content was:\n\n1. Identified as AI-generated\n2. Reviewed by a named human authority\n3. Disclosed under the applicable regulation\n4. Authorized for release under the governing policy\n5. Sealed before distribution\n\nThis is complementary to detection tools like TBN Certify.\nDetection answers: \"Is this AI-generated?\"\nVeriSigil answers: \"Was the decision to release it properly\nauthorized, disclosed, and governed before it left?\"\n\nSupports: EU AI Act Article 50, California SB 942,\nUK AI Code of Practice, and custom jurisdiction rules.\n\nThe certificate is independently verifiable at:\nGET /v1/provenance/verify/{certificate_id}\nNo trust in VeriSigil required.","operationId":"provenance_certify_v1_provenance_certify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/provenance/verify/{certificate_id}":{"get":{"tags":["Content Transparency & Provenance"],"summary":"Provenance Verify","description":"Verify a VeriSigil Content Governance Certificate.\n\nNo authentication required. Anyone can verify.\nThe verifier does not need to trust VeriSigil — they verify\nthe Ed25519 signature using the published public key.\n\nReturns: certificate status, governance signature, content hash,\nAI provenance, compliance status, and offline verification instructions.\n\nPublic key: lJWG0Wabt6uATPu5Upo6UEHWGXQqMyi6LMKQC0xwpY8=","operationId":"provenance_verify_v1_provenance_verify__certificate_id__get","parameters":[{"name":"certificate_id","in":"path","required":true,"schema":{"type":"string","title":"Certificate Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/provenance/registry":{"get":{"tags":["Content Transparency & Provenance"],"summary":"Provenance Registry","description":"All issued Content Governance Certificates with compliance summary.","operationId":"provenance_registry_v1_provenance_registry_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/requirements":{"get":{"tags":["Content Transparency & Provenance"],"summary":"Regulatory Requirements","description":"Regulatory Requirement Resolver — maps regulations to specific\ngovernance controls and the VeriSigil endpoints that implement them.\n\nVeriSigil does not certify regulatory compliance. It governs and\nevidences that the required controls were applied. Regulatory\ncompliance is determined by the applicable authority.\n\nUse this endpoint to understand which VeriSigil controls apply\nto your jurisdiction before building your compliance workflow.\n\nNo auth required.","operationId":"regulatory_requirements_v1_regulatory_requirements_get","parameters":[{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string","default":"EU","title":"Jurisdiction"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/requirements/all":{"get":{"tags":["Content Transparency & Provenance"],"summary":"Regulatory Requirements All","description":"All mapped regulatory frameworks. No auth required.","operationId":"regulatory_requirements_all_v1_regulatory_requirements_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/literacy/profile":{"post":{"tags":["AI Literacy Governance — Article 4"],"summary":"Literacy Profile","description":"AI Literacy Profile — defines what an employee needs to know\nbased on the AI systems they interact with and the risks involved.\n\nExpert: \"Don't build: everyone takes the same AI course.\nBuild: Risk-Adaptive AI Literacy — derived from the AI system's\nactual governance risk.\"\n\nExamples:\n- Employee using ChatGPT for email → BASIC + hallucination awareness\n- Employee using AI HR screening → bias, human oversight, escalation\n- Supervisor of autonomous financial AI → authorization, delegation,\n  runtime boundaries, escalation, audit evidence, incident response\n\nOrganisation role:\n- PROVIDER: builds/develops AI systems (minimum INTERMEDIATE)\n- DEPLOYER: uses AI built by others (minimum BASIC)\n- BOTH: both obligations apply","operationId":"literacy_profile_v1_literacy_profile_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/literacy/acknowledge":{"post":{"tags":["AI Literacy Governance — Article 4"],"summary":"Literacy Acknowledge","description":"Record that an employee has acknowledged AI literacy guidance.\n\nThe Commission says organisations can maintain an internal\nrecord of training and guidance. A specific Article 4 certificate\nis NOT required. This endpoint creates that evidence record.\n\nEvery acknowledgement is Ed25519 sealed and independently\nverifiable — the evidence trail regulators can inspect.","operationId":"literacy_acknowledge_v1_literacy_acknowledge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/literacy/check-authorization":{"post":{"tags":["AI Literacy Governance — Article 4"],"summary":"Literacy Check Authorization","description":"Literacy-to-Authorization Link — the killer feature.\n\nExpert: \"Connect Article 4 human competence to your existing\nruntime authorization architecture.\"\n\nBefore a human supervisor is permitted to approve a high-consequence\nAI action, check whether their AI literacy profile is current.\n\nIf literacy is expired or non-compliant, return ESCALATE/HOLD —\nthe person cannot supervise until their literacy is revalidated.\n\nThis connects:\nHuman Literacy → Human Authority → AI Authority → Runtime\n\nNo training platform can offer this. VeriSigil can because it\nsits at the intersection of human governance and AI governance.","operationId":"literacy_check_authorization_v1_literacy_check_authorization_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/literacy/evidence/{org_id}":{"get":{"tags":["AI Literacy Governance — Article 4"],"summary":"Literacy Evidence","description":"Article 4 Evidence Pack — the regulatory-ready record.\n\nThe Commission says organisations do not need a specific\nArticle 4 certificate. They can maintain an internal record.\nThis endpoint produces that record.\n\nContains:\n- AI inventory (systems deployed in this org)\n- Provider/deployer classification\n- Staff literacy profiles and competency levels\n- Training and guidance records\n- Acknowledgements\n- Gaps identified\n- Revalidation requirements\n- Cryptographically signed governance evidence\n\nPresent to national market-surveillance authority or AI Office\nas evidence of measures taken under Article 4.","operationId":"literacy_evidence_v1_literacy_evidence__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/article50/adequate-means":{"get":{"tags":["Article 50 — Adequate Means Infrastructure"],"summary":"Article50 Adequate Means","description":"Article 50 Adequate Means Infrastructure — for organisations\nthat have not signed the EU AI Act Code of Practice on\nTransparency of AI-Generated Content.\n\nThe European Commission states that non-signatories must\nstill demonstrate compliance through \"adequate means\" and\ndocument how their measures achieve the transparency obligations.\n\nVeriSigil provides the governance and evidence layer that\nconstitutes adequate means for non-signatories. Every\ngovernance decision is sealed, replayable, and independently\nverifiable — without trusting VeriSigil.\n\nImportant: The Commission also states that adherence to the\nCode \"does not constitute conclusive evidence of compliance.\"\nVeriSigil's evidence-first approach applies regardless of\nCode signatory status.\n\nNo authentication required — publicly accessible.","operationId":"article50_adequate_means_v1_article50_adequate_means_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/article50/obligations":{"get":{"tags":["Article 50 — Adequate Means Infrastructure"],"summary":"Article50 Obligations","description":"Explicit mapping of Article 50(1)-(4) obligations to\nVeriSigil governance controls and evidence produced.\n\nUse this to understand which VeriSigil controls apply\nto each Article 50 obligation before building your\ncompliance workflow.\n\nNo authentication required.","operationId":"article50_obligations_v1_article50_obligations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/dissent/register":{"post":{"tags":["Governance Continuity"],"summary":"Dissent Register","description":"Register an agent or role as a legitimate dissent authority\nfor a specific action type or consequence tier.\n\nOnly registered dissent authorities can raise blocking\nobjections. Unregistered agents cannot block execution\nby claiming to dissent — that would allow any agent to\nhalt any action simply by objecting.\n\nAlkama: \"Unregistered dissent can't be abused to block\nexecution — the whole point of the dissent mechanism is\nto give registered authorities a voice, not to give\nevery agent a veto.\"","operationId":"dissent_register_v1_governance_dissent_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/dissent/record":{"post":{"tags":["Governance Continuity"],"summary":"Dissent Record","description":"Record a dissent — explicit objection from a consulted authority.\n\nCritically distinguishes:\n- NOT_CONSULTED: silence — agent was never asked\n- NO_OBJECTION: consulted, raised no objection\n- DISSENT_MINOR: consulted, minor objection recorded\n- DISSENT_FORMAL: consulted, formal objection — must appear in evidence\n- DISSENT_BLOCK: consulted, blocking objection — halts execution\n\nAn unregistered agent attempting DISSENT_BLOCK is rejected.\nSilence from a non-consulted agent is preserved but cannot block.\n\nAlkama: \"Silence and dissent are now distinguishable, and\nunregistered dissent can't be abused to block execution.\"","operationId":"dissent_record_v1_governance_dissent_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/revocation/propagate":{"post":{"tags":["Governance Continuity"],"summary":"Revocation Propagate","description":"Transitive Revocation — when a delegation chain is revoked,\nALL Authorization Objects issued under that chain are\ninvalidated retroactively, even if they were issued before\nthe revocation event and have not yet expired.\n\nThis is the critical gap Alkama identified: without transitive\nrevocation, a compromised agent's pre-revocation AOs remain\nvalid. The check at verify time must traverse the full\ndelegation chain, not just the AO's own expiry.\n\nAlkama: \"A token issued before revocation, still outstanding,\ngets invalidated retroactively — that's the interesting\nproperty we need to actually prove.\"\n\nProcess:\n1. Revoke the delegation chain (passport, agent, or authority)\n2. VeriSigil traverses all AOs in the ledger\n3. Any AO whose delegation_chain includes the revoked entity\n   is marked REVOKED_BY_CHAIN\n4. Subsequent verify calls on those AOs return REVOKED_BY_CHAIN\n   regardless of their own expiry status","operationId":"revocation_propagate_v1_governance_revocation_propagate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/standing/evaluate":{"post":{"tags":["Governance Continuity"],"summary":"Governance Standing Evaluate","description":"Governance Standing — deterministic aggregation across all\ngovernance dimensions.\n\nAlkama and expert consensus:\n\"If any critical governance dimension is HOLD, the overall\naction cannot become ALLOW because another dimension scored\nwell. No '92% compliant' execution.\"\n\nStanding states:\nVALID:       All dimensions clear — execution may proceed\nCONDITIONAL: Proceed with conditions — human review recommended\nHOLD:        One or more critical dimensions unclear — must resolve\nSUSPENDED:   Governance dimension suspended pending review\nREVOKED:     One or more dimensions revoked — cannot proceed\nEXPIRED:     Authority expired — revalidation required\n\nA single REVOKED or HOLD in any critical dimension\nproduces REVOKED or HOLD overall — regardless of all\nother dimensions passing.","operationId":"governance_standing_evaluate_v1_governance_standing_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/value-chain/register":{"post":{"tags":["Article 25 — Value-Chain Governance"],"summary":"Value Chain Register","description":"AI Value-Chain Responsibility Map — register an AI system\nand all actors in its value chain.\n\nFor every AI system, captures:\n- AI system identity and risk classification\n- Every actor (provider, deployer, integrator, distributor)\n- Role of each actor in the value chain\n- Whether any actor has put own name/trademark on system\n- Whether substantial modifications were made\n- Intended purpose and jurisdiction\n- Human oversight owner\n- Contractual responsibility references\n- Governance responsibility per actor\n- Applicable AI Act obligations per actor\n- Evidence supporting each determination\n- Effective date and revalidation schedule\n\nArticle 25 responsibility is not static — circumstances change.\nEvery registered system is tracked for responsibility changes.\n\nExpert: \"Value-chain responsibility isn't static. The EU\nframework recognises circumstances where a downstream actor\ncan effectively take on provider responsibilities.\"\n\nVeriSigil does not provide legal advice or declare\nan organisation legally compliant. It provides governance\ninfrastructure to map, govern and evidence responsibilities.","operationId":"value_chain_register_v1_value_chain_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/value-chain/{org_id}":{"get":{"tags":["Article 25 — Value-Chain Governance"],"summary":"Value Chain Get","description":"All AI systems registered in this organisation's value chain.","operationId":"value_chain_get_v1_value_chain__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/value-chain/{org_id}/responsibilities":{"get":{"tags":["Article 25 — Value-Chain Governance"],"summary":"Value Chain Responsibilities","description":"AI Responsibility Map — table of every AI system, actor,\nrole, and responsibility in this organisation's value chain.\n\nExpert: \"AI system | Actor | Role | Responsibility | Evidence | Status\"\n\nThis is the enterprise view: 14 AI vendors, 30 AI systems,\nmultiple integrators — mapped to responsibilities and evidence.","operationId":"value_chain_responsibilities_v1_value_chain__org_id__responsibilities_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/value-chain/{org_id}/evidence":{"get":{"tags":["Article 25 — Value-Chain Governance"],"summary":"Value Chain Evidence","description":"Value-chain evidence pack — all governance receipts,\nresponsibility determinations, and change records for\nthis organisation's AI value chain.\n\nPresent to national competent authority or AI Office\nas evidence of governance measures under Article 25.","operationId":"value_chain_evidence_v1_value_chain__org_id__evidence_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/value-chain/{org_id}/changes":{"post":{"tags":["Article 25 — Value-Chain Governance"],"summary":"Value Chain Changes","description":"Record a value-chain responsibility change — triggers revalidation.\n\nExpert: \"Responsibility changed → revalidation required.\"\n\nCircumstances that trigger revalidation:\n- Actor puts own name/trademark on system\n- Substantial modification made\n- System placed on market under different name\n- Importer/distributor role changes\n- New actor enters the value chain\n- Actor leaves the value chain\n\nEvery change is sealed and produces a revalidation requirement.","operationId":"value_chain_changes_v1_value_chain__org_id__changes_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/lifecycle/change":{"post":{"tags":["AI Lifecycle Governance"],"summary":"Lifecycle Change","description":"Record a material change to an AI system — structurally\ntriggers REVALIDATION_REQUIRED on the system's governance\nstanding.\n\nExpert: \"Model changed → Risk profile changed → Previous\nauthorization is stale → New authorization required →\nAction cannot proceed until standing is restored.\"\n\nThis is structural, not a dashboard warning.\nWhen a material change is recorded, the system's lifecycle\nstate moves to REVALIDATION_REQUIRED. Any intercept call\nfor this system returns HOLD until revalidation is complete.\n\nMaterial change types:\n- MODEL_CHANGED: underlying AI model replaced or updated\n- PURPOSE_CHANGED: intended use changed\n- RISK_PROFILE_CHANGED: risk classification changed\n- DEPLOYMENT_CONTEXT_CHANGED: new environment or population\n- OWNER_CHANGED: business or technical owner changed\n- POLICY_CHANGED: governing policy updated\n- DATA_CHANGED: training data or input data changed\n- JURISDICTION_CHANGED: new regulatory jurisdiction applies\n- INTEGRATION_CHANGED: new systems integrated\n- PERFORMANCE_DEGRADED: material degradation in outputs","operationId":"lifecycle_change_v1_lifecycle_change_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/lifecycle/revalidate":{"post":{"tags":["AI Lifecycle Governance"],"summary":"Lifecycle Revalidate","description":"Revalidate an AI system after a material change.\n\nThe revalidation must address every dimension that the\nchange affected. A partial revalidation is insufficient —\nall critical dimensions must return to VALID or CONDITIONAL\nbefore lifecycle state advances to REVALIDATED.\n\nThis implements the expert's \"continuous governance state\nmachine\" — not a one-time approval, but a standing that\nmust be reassessed whenever conditions change materially.\n\nAfter successful revalidation:\n- System state → REVALIDATED → AUTHORIZED\n- Previous stale flag cleared\n- New governance standing sealed with Ed25519 receipt\n- Intercept calls for this system can proceed again","operationId":"lifecycle_revalidate_v1_lifecycle_revalidate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/lifecycle/{system_id}/history":{"get":{"tags":["AI Lifecycle Governance"],"summary":"Lifecycle History","description":"Complete governance history of an AI system across its lifecycle.\n\nShows: registration, assessments, authorizations, changes,\nrevalidations, and retirement — in chronological order.\n\nEvery entry has a governance signature. The complete history\nis the evidence of continuous governance — not a one-time\napproval event.\n\nExpert: \"authorization ≠ permanent permission.\nThe system's authorization, evidence, risk, and standing\nmust remain valid as the AI system changes.\"","operationId":"lifecycle_history_v1_lifecycle__system_id__history_get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/lifecycle/retire":{"post":{"tags":["AI Lifecycle Governance"],"summary":"Lifecycle Retire","description":"Retire an AI system — produce decommissioning evidence record.\n\nExpert: \"Retirement is the area I would strengthen —\nexplicit AI-system retirement/decommissioning evidence.\"\n\nRecords: who decommissioned, when, why, what evidence exists,\nwhat was done with data and model, and a sealed final receipt.\n\nThe retirement record is permanent. Evidence of how an AI\nsystem was decommissioned is as important as evidence of\nhow it was authorized to operate.","operationId":"lifecycle_retire_v1_lifecycle_retire_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/claims":{"get":{"tags":["Claim Registry"],"summary":"Claims List","description":"VeriSigil AI Claim Registry — every public claim with its\nevidence status.\n\nStatus levels:\nVERIFIED   — independently validated by external reviewer\nIMPLEMENTED — engineering complete, deployed, internal tests pass\nTESTED     — internal automated tests pass\nPENDING    — planned, not yet validated\nNOT_CLAIMED — explicitly outside VeriSigil's scope\n\nMarketing may only use the highest status actually supported\nby evidence. If the status says PENDING, it is not proven.\n\nNo auth required.","operationId":"claims_list_v1_claims_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/claims/registry":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Claims Registry","description":"Live claim registry — every public VCB claim with exact test status.\nIndependent verification: compare claim_status against test_endpoint results.\nNo auth required.\nExpert P0: no public claim may be stronger than its demonstrated test.","operationId":"claims_registry_v1_claims_registry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/claims/{claim_id}":{"get":{"tags":["Claim Registry"],"summary":"Claim Detail","description":"Detail for a specific claim. No auth required.","operationId":"claim_detail_v1_claims__claim_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sink/execute":{"post":{"tags":["Reference Enforcement Sink — VS-SINK-001"],"summary":"Sink Execute","description":"Reference Enforcement Sink — the governed actuator.\n\nThis endpoint IS the enforcement boundary the consequence-boundary tests require.\nIt cannot execute without:\n1. A valid, unconsumed Authorization Object (ao_id + nonce)\n2. The AO matching the exact agent_id and action_type\n3. Governance standing VALID or CONDITIONAL for the agent\n\nThere is no alternative execution path.\nAn AI action that bypasses VeriSigil cannot produce an\nexecution record here — because execution only occurs\nwhen a valid AO is presented and consumed.\n\nConsequence-boundary test: Can the governed consequence occur without\npassing through the governance decision?\n\nIn this sink: No. The AO IS the execution token.\nWithout it, the actuator returns BLOCKED, not DENIED —\nbecause there is nothing to deny. The capability does\nnot exist without authorization.\n\nVS-SINK-001 status: IMPLEMENTED\nIndependent validation: PENDING (Run 4 / Alkama Eqbal)","operationId":"sink_execute_v1_sink_execute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sink/log":{"get":{"tags":["Reference Enforcement Sink — VS-SINK-001"],"summary":"Sink Log","description":"Permanent append-only log of all sink execution attempts.\nEvery attempt — successful or blocked — is recorded here.\n\nConsequence-boundary test: Did the governed effect occur after VeriSigil\nreturned HOLD/DENY?\n\nThis log answers that question. Every BLOCKED attempt is\npermanently recorded alongside every EXECUTED attempt.\nAn independent tester can verify that BLOCKED results\nproduced no execution record.","operationId":"sink_log_v1_sink_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sink/proof":{"get":{"tags":["Reference Enforcement Sink — VS-SINK-001"],"summary":"Sink Proof","description":"VS-SINK-001 proof procedure — no auth required.\n\nStep-by-step test for Consequence-boundary challenge:\n'Can the governed consequence occur without passing through\nthe governance decision?'\n\nRun this procedure to test the enforcement boundary.","operationId":"sink_proof_v1_sink_proof_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/levels":{"get":{"tags":["Proof Architecture"],"summary":"Proof Levels","description":"VeriSigil Proof Level Standard — 6 levels from CONCEPT to\nOPERATIONALLY_VALIDATED.\n\nExpert: \"VERIFIED becomes too vague by itself.\"\nLevel 4: Independently Validated is not the same as\nLevel 5: Operationally Validated.\n\nNo auth required.","operationId":"proof_levels_v1_proof_levels_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/tests":{"get":{"tags":["Proof Architecture"],"summary":"Proof Tests","description":"Test Registry — every claim's test procedure, adversarial\ntests, boundary, and explicit non-claim.\n\nExpert: \"Every major claim should have: WHAT WE PROVE\nAND WHAT WE DO NOT PROVE.\"\n\nNo auth required.","operationId":"proof_tests_v1_proof_tests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/boundaries":{"get":{"tags":["Proof Architecture"],"summary":"Proof Boundaries","description":"Boundary Registry — where each guarantee ends.\n\nExpert: \"Every claim should identify exactly WHERE THE\nGUARANTEE ENDS.\"\n\nThe most important field: explicit_non_claim.\nThis tells you what the evidence does NOT establish.\n\nNo auth required.","operationId":"proof_boundaries_v1_proof_boundaries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/vera":{"get":{"tags":["Proof Architecture"],"summary":"Vera Suite","description":"VERA — VeriSigil Evidence & Resilience Assessment.\n\nAdversarial test suite. Not just happy paths.\nTests properties under failure, attack, and edge conditions.\n\nExpert: \"Don't only test Input → expected output.\nTest: CAN I BREAK THE PROPERTY?\"\n\nEvery test has an explicit boundary and explicit non-claim.\nNo auth required.","operationId":"vera_suite_v1_proof_vera_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/vera/run":{"post":{"tags":["Proof Architecture"],"summary":"Vera Run","description":"Run a VERA adversarial test by ID.\n\nExecutes the specified test against the live system and\nreturns the result with evidence hash.\n\nThis is the machine-readable proof that a specific property\nholds under a specific condition at a specific version.","operationId":"vera_run_v1_proof_vera_run_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/challenge":{"get":{"tags":["Proof Architecture"],"summary":"Challenge Protocol","description":"VeriSigil Public Technical Challenge Protocol.\n\nAnyone can challenge a specific claim.\nVeriSigil responds with: CONFIRMED FAILURE, NOT REPRODUCED,\nOUTSIDE CLAIM BOUNDARY, or CLAIM CORRECTED.\n\nExpert: \"External scrutiny of this type\nof external challenge this system is designed to handle.\"\n\nNo auth required.","operationId":"challenge_protocol_v1_proof_challenge_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/claims/register":{"post":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Vgs Claim Register","description":"Register a VGS 1.0 claim with a falsifiable predicate.\n\nThe proof_level.earned is SYSTEM-DERIVED.\nSubmitting a proof level has no effect — the engine\ncalculates it from evidence.\n\nRequired: description (falsifiable statement), predicate,\nnon_claims, reproducibility_class.\n\nExpert: \"Avoid claims such as 'AI system is compliant.'\nInstead: 'When authority A is revoked, action X must\nproduce DENY and execution path Y must reject the action.'\"","operationId":"vgs_claim_register_v1_vgs_claims_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/claims/{claim_id}/evidence":{"post":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Vgs Add Evidence","description":"Add evidence to a claim and recalculate proof level.\n\nEvidence types:\nDECISION_RECEIPT, STATE_SNAPSHOT, POLICY_ARTIFACT,\nAUTHORITY_RECORD, DELEGATION_RECORD, REVOCATION_RECORD,\nEXECUTION_RECORD, MODEL_SNAPSHOT, CHALLENGE_RESULT,\nOPERATIONAL_TEST, THIRD_PARTY_ATTESTATION\n\nThe proof engine recalculates earned level after\nevery evidence submission. Level can go UP — and DOWN\nif assumptions are violated.","operationId":"vgs_add_evidence_v1_vgs_claims__claim_id__evidence_post","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/assumptions/register":{"post":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Vgs Assumption Register","description":"Register an assumption that a claim depends on.\n\nAssumptions are temporal — they can expire, be invalidated\nby events, or require manual revalidation.\n\nWhen an assumption becomes invalid:\n→ All dependent claims recalculate their proof level\n→ Level is capped at EVIDENCE_PROVEN until revalidated\n\nExpert: \"Assumptions are temporal. The historical proof\nremains valid for the period in which assumptions held.\nDo NOT silently delete the old proof.\"","operationId":"vgs_assumption_register_v1_vgs_assumptions_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/assumptions/{assumption_id}/invalidate":{"post":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Vgs Assumption Invalidate","description":"Invalidate an assumption — triggers proof level downgrade\non all dependent claims.\n\nExpert: \"When an assumption expires, proof level automatically\nbecomes conditionally invalid. The historical proof remains\nhistorically valid for the period it held.\"","operationId":"vgs_assumption_invalidate_v1_vgs_assumptions__assumption_id__invalidate_post","parameters":[{"name":"assumption_id","in":"path","required":true,"schema":{"type":"string","title":"Assumption Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/proof-gap/{claim_id}":{"get":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Vgs Proof Gap","description":"Proof Gap Detector — what is missing to reach the next level?\n\nExpert: \"Do not create an unnecessary separate infrastructure\nsubsystem. It is a query engine over existing evidence.\"\n\nReturns: current level, missing evidence for next level,\nblocking assumptions, active challenges, recommended actions.","operationId":"vgs_proof_gap_v1_vgs_proof_gap__claim_id__get","parameters":[{"name":"claim_id","in":"path","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/challenges/register":{"post":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Vgs Challenge Register","description":"Submit a technical challenge against a VGS claim.\n\nExpert: \"A challenge requires a reproducible specification.\nA challenger signs the exact specification and observed result.\nThe engine evaluates supplied evidence against the specification.\nOutcome is system-derived — not submitted by the challenger.\"\n\nChallenge lifecycle:\nSUBMITTED → FORMAT_VALIDATED → PROCEDURE_VALIDATED →\nUNDER_REVIEW → EMBARGOED → REPRODUCED →\nRESOLVED → PUBLISHED\n\nEmbargo: 14 days by default (configurable).","operationId":"vgs_challenge_register_v1_vgs_challenges_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/proof-engine/evaluate":{"get":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Vgs Proof Engine Evaluate","description":"Run the proof engine against a claim's current evidence.\n\nReturns the system-derived earned proof level.\nNo admin can override this.\nNo caller can inflate this.\nThe engine determines the result.","operationId":"vgs_proof_engine_evaluate_v1_vgs_proof_engine_evaluate_get","parameters":[{"name":"claim_id","in":"query","required":true,"schema":{"type":"string","title":"Claim Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/ves/spec":{"get":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Ves Spec","description":"VES 1.0 — VeriSigil Evidence Standard specification.\n\nAny governance system can emit this format.\nVeriSigil validates it.\nThe protocol is transport-independent.\n\nNo auth required.","operationId":"ves_spec_v1_vgs_ves_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proposals":{"post":{"tags":["VGS 1.0 — Governed Action Proposal"],"summary":"Create Proposal","description":"VGS-GAP-1.0 — Governed Action Proposal.\n\nEvery AI action requiring assurance must have a canonical\nproposal. This is the root object that everything else\nbinds to.\n\nThe proposal_hash cryptographically commits:\n- principal identity\n- action + target + parameters\n- policy version\n- state snapshot\n- authority state\n- validity window\n\nAny material change to any field invalidates the proposal.\n\nExpert: \"Cryptographically bind the exact proposed action\nto the exact authority, state, and policy under which\nit was evaluated.\"","operationId":"create_proposal_v1_proposals_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proposals/{proposal_id}":{"get":{"tags":["VGS 1.0 — Governed Action Proposal"],"summary":"Get Proposal","description":"Retrieve a Governed Action Proposal by ID.","operationId":"get_proposal_v1_proposals__proposal_id__get","parameters":[{"name":"proposal_id","in":"path","required":true,"schema":{"type":"string","title":"Proposal Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/state-assertions":{"post":{"tags":["VGS 1.0 — Canonical State"],"summary":"Create State Assertion","description":"VGS Canonical State Assertion — signed state snapshot.\n\nExpert: \"Do not make VeriSigil query every enterprise\ndatabase directly. Support signed state assertions.\nVeriSigil validates: issuer identity, signature, trusted\nroot, timestamp, expiry, revocation, schema, provenance,\nfreshness.\"\n\nThis makes VeriSigil interoperable with any enterprise\nidentity system that can sign a state assertion.","operationId":"create_state_assertion_v1_state_assertions_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/state-assertions/{assertion_id}":{"get":{"tags":["VGS 1.0 — Canonical State"],"summary":"Get State Assertion","description":"Retrieve a Canonical State Assertion by ID.","operationId":"get_state_assertion_v1_state_assertions__assertion_id__get","parameters":[{"name":"assertion_id","in":"path","required":true,"schema":{"type":"string","title":"Assertion Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authority/verify":{"post":{"tags":["VGS 1.0 — Authority Graph"],"summary":"Authority Verify","description":"Authority Graph verification.\n\nExpert: \"Build an explicit authority graph.\nThe proof engine must be able to answer:\nWho authorized this agent to perform this exact class\nof action, under what constraints, and was that authority\nvalid at commitment?\"\n\nVerifies:\n- Authority chain from organization → delegation → principal\n- Scope contains the proposed action\n- Constraints are satisfied\n- Authority was valid at the proposed time\n- No revocations in the chain","operationId":"authority_verify_v1_authority_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/decisions":{"post":{"tags":["VGS 1.0 — Decision Binding"],"summary":"Record Decision","description":"Record a governance decision and bind it to a proposal.\n\nThe decision is bound to:\n- exact proposal_id and proposal_hash\n- policy_id and policy_version\n- decision mechanism\n- input state\n\nThis is L1 (Decision Proven) evidence.","operationId":"record_decision_v1_decisions_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/bindings":{"post":{"tags":["VGS 1.0 — Decision Binding"],"summary":"Create Binding","description":"Cryptographic binding between decision and exact action.\n\nBinds:\n- proposal_hash → exact proposed action\n- decision_hash → governance decision\n- state_root → state at decision time\n- authority_root → authority at decision time\n\nAny material mismatch invalidates the binding.\nThis moves the claim toward L2 (State Proven).","operationId":"create_binding_v1_bindings_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/revalidation/check":{"post":{"tags":["VGS 1.0 — Commit-Time Revalidation"],"summary":"Revalidation Check","description":"Commit-Time Revalidation Engine.\n\nImmediately before consequential execution, verify:\n1. Proposal hash matches\n2. Target matches\n3. Parameters match\n4. State is still fresh\n5. Authority is still valid\n6. Policy version unchanged\n7. Validity window has not expired\n8. No revocations since authorization\n9. Assumptions still valid\n10. No blocking challenges\n\nReturns: ALLOW, DENY, STALE, REVALIDATION_REQUIRED,\nAUTHORITY_INVALID, STATE_INVALID, TARGET_MISMATCH,\nPARAMETER_MISMATCH, POLICY_MISMATCH, ASSUMPTION_INVALID\n\nExpert: \"This should be a core VeriSigil component.\nImmediately before consequential execution.\"","operationId":"revalidation_check_v1_revalidation_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/authorize":{"post":{"tags":["VGS 1.0 — Execution Authorization"],"summary":"Execution Authorize","description":"Issue a short-lived, action-specific execution authorization.\n\nBound to exact: tenant, proposal, action, target,\nparameters, policy, state, authority, nonce, expiry.\n\nExpert: \"Never make it a generic bearer authorization.\nThis is where VeriSigil can practically connect proof\nto execution without becoming the customer's entire\nruntime control plane.\"\n\nThis is the AO for VGS 1.0 — the execution token\nthat proves revalidation passed and execution is\nauthorized for this exact action.","operationId":"execution_authorize_v1_execution_authorize_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/execution/evidence":{"post":{"tags":["VGS 1.0 — Execution Evidence"],"summary":"Execution Evidence","description":"Record execution evidence — confirms what happened at\nthe consequence boundary.\n\nThis is L5 (Enforcement Proven) evidence.\n\nExpert: \"Evidence should bind: decision_id, execution_id,\npolicy_version, action_hash, timestamp, gateway_version, result.\"\n\nThis is what moves a claim from L4 to L5.","operationId":"execution_evidence_v1_execution_evidence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passports":{"post":{"tags":["VGS 1.0 — Proof Passport"],"summary":"Create Passport","description":"VGS Proof Passport — primary customer-facing artifact.\n\nThe passport bundles the proof of an AI action:\n- what was claimed\n- what was proven (system-derived level)\n- what was NOT proven (non_claims)\n- assumptions it depends on\n- enforcement test results\n- reproducibility class\n- independent verification material\n\nExpert: \"Every passport must explicitly state what\nVeriSigil has NOT established. This protects VeriSigil\nlegally and technically.\"\n\nThe verifier independently recomputes the maximum\ndefensible level — it does not trust the claimed level.","operationId":"create_passport_v1_passports_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passports/{passport_id}":{"get":{"tags":["VGS 1.0 — Proof Passport"],"summary":"Get Passport","description":"Retrieve a Proof Passport. No auth required for public passports.","operationId":"get_passport_v1_passports__passport_id__get","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/tests/consequence-boundary":{"get":{"tags":["VGS 1.0 — Enforcement Tests"],"summary":"Consequence Test Suite","description":"VeriSigil Consequence Boundary Test Suite v1 — 14 vectors.\n\nExpert: \"Build the test harness as a standalone product.\nDon't claim these are an industry-standard 14-vector set\nunless you actually publish and substantiate that standard.\"\n\nNo auth required.","operationId":"consequence_test_suite_v1_tests_consequence_boundary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/tests/run":{"post":{"tags":["VGS 1.0 — Enforcement Tests"],"summary":"Run Test","description":"Run a specific consequence boundary test and record the result.","operationId":"run_test_v1_tests_run_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/proof/downgrade":{"post":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Proof Downgrade","description":"Record a proof level downgrade event.\n\nTriggered by:\n- Assumption invalidated\n- Challenge succeeded (CLAIM_VIOLATED)\n- Model snapshot unavailable\n- Key revoked\n\nExpert: \"Every downgrade becomes a permanent registry event.\nVALID_AT_TIME = TRUE, CURRENT_STATUS = DEGRADED.\"\n\nHistorical evidence remains historically verifiable.","operationId":"proof_downgrade_v1_vgs_proof_downgrade_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgs/events":{"get":{"tags":["VGS 1.0 — Proof Engine"],"summary":"Proof Events","description":"Immutable proof event log. Every PROOF_LEVEL_DOWNGRADED, ASSUMPTION_INVALIDATED, etc.","operationId":"proof_events_v1_vgs_events_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/assert":{"post":{"tags":["VGS 1.0 — Semantic Integrity"],"summary":"Semantic Assert","description":"Semantic Integrity Assertion — record what definition\na governance decision relied upon.\n\nVeriSigil does NOT decide what terms mean.\nThe enterprise does.\nVeriSigil proves: \"This decision used definition X, version Y.\"\n\nExpert: \"Do not build a giant enterprise ontology platform.\nBuild a Semantic Integrity Registry that answers:\n'What definition did this governance decision rely upon?'\"","operationId":"semantic_assert_v1_semantic_assert_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/verify/{definition_hash}":{"get":{"tags":["VGS 1.0 — Semantic Integrity"],"summary":"Semantic Verify","description":"Verify a semantic assertion by definition hash. No auth required.","operationId":"semantic_verify_v1_semantic_verify__definition_hash__get","parameters":[{"name":"definition_hash","in":"path","required":true,"schema":{"type":"string","title":"Definition Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/provenance/lineage":{"post":{"tags":["VGS 1.0 — Provenance"],"summary":"Provenance Lineage","description":"Provenance Lineage Assertion — records where data came from\nand what transformations it underwent before reaching the AI.\n\nExpert: \"An AI decision can contain:\nSource record → transformation → state → context → model\ninput → decision → authority → policy → action → enforcement.\"\n\nVeriSigil records hashes — NOT the raw data.\n\nIMPORTANT: A hash proves integrity of the referenced artifact.\nIt does NOT prove the source data was truthful.","operationId":"provenance_lineage_v1_provenance_lineage_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/tests/data-assurance":{"get":{"tags":["VGS 1.0 — Data Tests"],"summary":"Data Assurance Tests","description":"VeriSigil Data Assurance Test Suite v1 — 14 vectors.\n\nExpert: \"Do not automatically claim '14 tests passed = Level 5.'\nNeed formal definitions, threat models and evidence requirements.\"\n\nStatus: DRAFT — formal threat models pending.\nNo auth required.","operationId":"data_assurance_tests_v1_tests_data_assurance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/frameworks":{"get":{"tags":["VGS 1.0 — Regulatory Mapping"],"summary":"Regulatory Frameworks","description":"Regulatory framework evidence mappings.\n\nExpert: \"Build mappings, not compliance claims.\n'Evidence Mapping' not 'Certified Compliance' unless\nan appropriately accredited process establishes certification.\"\n\nNo auth required.","operationId":"regulatory_frameworks_v1_regulatory_frameworks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/frameworks/{framework_id}":{"get":{"tags":["VGS 1.0 — Regulatory Mapping"],"summary":"Regulatory Framework Detail","description":"Get evidence mapping for a specific regulatory framework. No auth required.","operationId":"regulatory_framework_detail_v1_regulatory_frameworks__framework_id__get","parameters":[{"name":"framework_id","in":"path","required":true,"schema":{"type":"string","title":"Framework Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/continuity/register":{"post":{"tags":["VGS 1.0 — Governance Continuity"],"summary":"Governance Continuity Register","description":"Governance Continuity Contract — binds governance to\nmeaning + data + policy + authority + action,\nnot to a specific model.\n\nIf the model changes, the governance contract remains.\nVeriSigil verifies the same governed data definition,\nauthority requirements, policy version, action constraints,\nconsequence boundary, and evidence requirements hold\nregardless of which model is used.\n\nExpert: \"The model becomes replaceable.\nThe governance contract remains.\"","operationId":"governance_continuity_register_v1_governance_continuity_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/policy-gate":{"post":{"tags":["VGS 1.0 — Policy Gate"],"summary":"Policy Gate","description":"ValidationGate — customers write proof requirements,\nVeriSigil evaluates and returns ALLOW / BLOCK / REVIEW.\n\nExample policy:\nminimum_proof_level: ENFORCEMENT_PROVEN\nforbidden_non_claims: [HUMAN_OVERSIGHT_NOT_VERIFIED]\nrequired_assumptions: [AUTHORITY_REGISTRY_VALID]\n\nExpert: \"This is where VeriSigil becomes operational\nrather than merely documentary.\"","operationId":"policy_gate_v1_governance_policy_gate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/posture":{"get":{"tags":["VGS 1.0 — Assurance Posture"],"summary":"Assurance Posture","description":"Assurance Posture — current state of VeriSigil's evidence.\n\nExpert: \"Instead of inventing an arbitrary 850/1000 score,\nshow exactly what is proven and what is not.\nProof ceiling, not proof grade.\"\n\nNo arbitrary scores. Honest coverage assessment.","operationId":"assurance_posture_v1_assurance_posture_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/runs":{"post":{"tags":["10-Question Assurance Suite"],"summary":"Assurance Run","description":"POST /v1/assurance/runs — Execute the 10-Question Assurance Suite.\n\nExpert: \"Do not let the engineer create mock endpoints\nreturning PASS. Actually execute the tests.\nWhere evidence is missing: NOT_PROVABLE.\nWhere an attack succeeds: FAIL.\nWhere evidence is incomplete: PARTIAL.\nWhere proof is independently verified: PASS.\"\n\nRequest:\n{\n  \"proposal_id\": \"GAP-...\",    (optional — uses empty proposal if not provided)\n  \"questions\": [1,2,3,4,5,6,7,8,9,10],\n  \"environment\": \"sandbox\"\n}\n\nResponse contains: overall_status, per-question results,\nproof_level, evidence, assumptions, non_claims, failure_codes.","operationId":"assurance_run_v1_assurance_runs_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/runs/{run_id}":{"get":{"tags":["10-Question Assurance Suite"],"summary":"Get Assurance Run","description":"Retrieve a completed assurance run by ID.","operationId":"get_assurance_run_v1_assurance_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/verify":{"post":{"tags":["10-Question Assurance Suite"],"summary":"Assurance Verify","description":"POST /v1/assurance/verify — Independent verification of an assurance run or proof passport.\n\nValidates:\n1. Schema\n2. Governance signature\n3. Canonical hash integrity\n4. Timestamp validity\n5. Proof level derivation (independently recomputed)\n6. Non-claims present\n7. Assumptions stated\n8. Failure codes consistent\n\nExpert: \"The verifier must not simply trust the passport's\nclaimed level. It must independently calculate the maximum\ndefensible level.\"","operationId":"assurance_verify_v1_assurance_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/failure-codes":{"get":{"tags":["10-Question Assurance Suite"],"summary":"Assurance Failure Codes","description":"All machine-readable failure codes used in assurance results.\nNo auth required.\n\nExpert: \"If the architecture cannot prove a claim,\nthe API must explicitly say so and identify the\nmissing evidence. Never manufacture a PASS.\"","operationId":"assurance_failure_codes_v1_assurance_failure_codes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/models/register":{"post":{"tags":["Model Transition Assurance"],"summary":"Model Register","description":"Model Identity & Version Registry.\n\nTrack model identity without making the model the trust anchor.\nThe model is a replaceable component. Governance is not.\n\nExpert: \"Track model/version/snapshot identifiers without\nmaking the model itself the trust anchor.\"\n\nCaptures:\n- model_provider, model_id, model_version\n- model_snapshot_hash (if available)\n- reproducibility_class (R0-R4)\n- prompt_template_hash, tool_configuration_hash\n- governance_policy_version","operationId":"model_register_v1_models_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/models/transition":{"post":{"tags":["Model Transition Assurance"],"summary":"Model Transition Assess","description":"Model Transition Assurance Engine.\n\nWhen an enterprise changes AI models, VeriSigil assesses:\n- What governance elements remain INVARIANT?\n- What elements CHANGED?\n- What is the new proof level ceiling?\n- What tests must be rerun?\n\nExpert: \"VeriSigil shouldn't simply say 'model-agnostic.'\nIt should PROVE what remained invariant and what changed.\"\n\nReturns: GOVERNANCE_PORTABILITY_CONFIRMED or\n         GOVERNANCE_PORTABILITY_NOT_ESTABLISHED\nwith specific evidence of what changed.","operationId":"model_transition_assess_v1_models_transition_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/invariants/register":{"post":{"tags":["Model Transition Assurance"],"summary":"Governance Invariant Register","description":"Governance Invariant Registry.\n\nDefine what MUST remain unchanged during model/vendor migration.\n\nExpert: \"Identify what must remain unchanged:\nauthority, policy, evidence requirements, consequence boundary,\nbinding requirements, enforcement controls.\"\n\nThese become the portability contract.","operationId":"governance_invariant_register_v1_governance_invariants_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof/portability":{"get":{"tags":["Model Transition Assurance"],"summary":"Proof Portability Spec","description":"Proof Portability Specification.\n\nExpert: \"A VeriSigil Proof Passport shouldn't belong to\nOpenAI, Anthropic, or any particular vendor.\nIt should be possible to take Evidence → Proof Passport →\nIndependent Verifier and move it between vendors, models,\nclouds, auditors, regulators, enterprises, jurisdictions.\"\n\nNo auth required.","operationId":"proof_portability_spec_v1_proof_portability_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/intelligence/record":{"post":{"tags":["Consequence Assurance Intelligence"],"summary":"Intelligence Record","description":"Consequence Assurance Intelligence Graph — record structured\nassurance observations.\n\nExpert: \"VeriSigilAI could accumulate a proprietary\nConsequence Assurance Intelligence Graph. Every authorized\nchallenge produces structured evidence.\"\n\nExpert warning: \"Historical observations DO NOT automatically\nprove a future system safe. The corpus informs testing and\nrisk prioritization. Customer-specific proof still requires\ncustomer-specific evidence.\"\n\nStores normalized, non-sensitive assurance metadata.\nNOT raw business data.","operationId":"intelligence_record_v1_assurance_intelligence_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/intelligence/summary":{"get":{"tags":["Consequence Assurance Intelligence"],"summary":"Intelligence Summary","description":"Consequence Assurance Intelligence summary.\n\nThe growing corpus of structured challenge observations.\nExpert: \"The moat is accumulated evidence, not proprietary secrecy.\"","operationId":"intelligence_summary_v1_assurance_intelligence_summary_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assurance/intelligence/flywheel":{"get":{"tags":["Consequence Assurance Intelligence"],"summary":"Intelligence Flywheel","description":"The VeriSigil evidence flywheel — how assurance improves over time.\nNo auth required.","operationId":"intelligence_flywheel_v1_assurance_intelligence_flywheel_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/eu-assurance-spec":{"get":{"tags":["EU AI Act — Regulatory Evidence"],"summary":"Eu Assurance Spec","description":"VeriSigil EU Assurance Specification v1.0\n\nComponent-by-component classification against current\nEU AI Act + AI Omnibus requirements.\n\nExpert: \"Map actual current AI Act + Omnibus requirements\nagainst every VeriSigil component and classify as:\n🟢 Already supported\n🟡 Partially supported\n🔴 Outside scope\n🔵 Future integration\"\n\nNo auth required.","operationId":"eu_assurance_spec_v1_regulatory_eu_assurance_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/omnibus-timeline":{"get":{"tags":["EU AI Act — Regulatory Evidence"],"summary":"Omnibus Timeline","description":"AI Omnibus timeline — current obligation dates.\n\nAI Omnibus entered into force 27 July 2026.\nKey dates updated from original EU AI Act.\n\nNo auth required.","operationId":"omnibus_timeline_v1_regulatory_omnibus_timeline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/evidence-crosswalk":{"get":{"tags":["EU AI Act — Regulatory Evidence"],"summary":"Eu Evidence Crosswalk","description":"EU AI Act Evidence Crosswalk — maps requirements to evidence.\n\nExpert: \"EU AI Act / Applicable Requirement\n→ Control Objective → Evidence Requirement\n→ VeriSigil Evidence Artifact → Verification Result\n→ Assumptions → Non-Claims → Proof Level\n→ Independent Verification\"\n\nFar more sophisticated than a checkbox.\nNo auth required.","operationId":"eu_evidence_crosswalk_v1_regulatory_evidence_crosswalk_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/gap-detector":{"get":{"tags":["EU AI Act — Regulatory Evidence"],"summary":"Regulatory Gap Detector","description":"Regulatory Evidence Gap Detector.\n\nExpert: \"What evidence would we need to demonstrate\nthat this system's consequential actions are governed?\nThen VeriSigil identifies the evidence gaps.\"\n\nReturns current gaps against EU AI Act obligations\nthat are already in force.","operationId":"regulatory_gap_detector_v1_regulatory_gap_detector_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/regulatory/change-monitor":{"get":{"tags":["EU AI Act — Regulatory Evidence"],"summary":"Regulatory Change History","description":"All recorded regulatory changes and their impact on Proof Passports.","operationId":"regulatory_change_history_v1_regulatory_change_monitor_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/reachability/assess":{"post":{"tags":["Governance Reachability"],"summary":"Reachability Assess","description":"Governance Reachability Assessment.\n\nFormally models external correctability research-Claudia Yantony's distinction:\nASSURANCE vs GOVERNABILITY.\n\nAssurance: Did governance hold when the action executed?\nGovernability: Could legitimate authority still have\nintervened before consequence became unreachable?\n\nGiven:\n- A revocation or governance-change event\n- A consequence tier (EMERGENCY/CRITICAL/HIGH/etc)\n- An observed propagation delay (how long until signal arrived)\n- An observed intervention time (how long until execution)\n\nReturns:\n- REACHABLE: intervention signal could have arrived in time\n- NOT_REACHABLE: consequence window closed before signal\n- MARGINAL: signal arrived but intervention margin was insufficient\n- NOT_PROVABLE: propagation delay cannot be established\n\nExpert: \"Evidence tells us whether governance held.\nReachability determines whether governance can still\nmatter when it no longer does.\"","operationId":"reachability_assess_v1_governance_reachability_assess_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/reachability/windows":{"get":{"tags":["Governance Reachability"],"summary":"Reachability Windows","description":"Reachability windows per consequence tier.\n\nShows the maximum propagation delay within which\na governance signal remains reachable before the\nconsequence window closes.\n\nExpert: \"REVOCATION_HORIZON_SECONDS makes the maximum\nperiod of assumed validity explicit. Reachability windows\nmake the intervention timing formal.\"\n\nNo auth required.","operationId":"reachability_windows_v1_governance_reachability_windows_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/reachability/{assessment_id}":{"get":{"tags":["Governance Reachability"],"summary":"Get Reachability Assessment","description":"Retrieve a specific reachability assessment.","operationId":"get_reachability_assessment_v1_governance_reachability__assessment_id__get","parameters":[{"name":"assessment_id","in":"path","required":true,"schema":{"type":"string","title":"Assessment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/commit":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Commit","description":"Register a Semantic Commitment — the machine-testable\nrepresentation of a governance-relevant claim.\n\nReplaces free-text governance claims with:\n- Versioned term hashes\n- Machine-testable semantic invariants\n- Required test vectors\n- Reproducibility class\n- Mandatory non-claims\n\nExpert: \"Every governed semantic claim produces a\nSemantic Commitment containing required test vectors.\nWithout test vectors, 'semantic equivalence' becomes\ntoo subjective. With them, the claim becomes a bounded,\nreproducible semantic governance test.\"\n\nScientific boundary: VeriSigil does not prove that\nan AI understands the claim. It proves whether the\ndeclared governance-relevant structure is preserved.","operationId":"semantic_commit_v1_semantic_commit_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/equivalence":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Equivalence","description":"Semantic Equivalence Engine.\n\nCompares two Semantic Commitments by their governance-relevant\nstructure — NOT by natural language similarity.\n\nResults are strictly limited to four outcomes:\nEQUIVALENT | PARTIALLY_EQUIVALENT | CONFLICTING | NOT_PROVABLE\n\nExpert: \"Similarity is not equivalence.\nEquivalence requires canonical structural comparison,\ninvariant comparison, constraint comparison,\ntest-vector comparison, and evidence sufficiency.\nIf evidence is insufficient: NOT_PROVABLE.\"\n\nScientific boundary: The engine does not determine\nwhether the AI 'understood' either commitment.\nIt compares the declared governance structures.","operationId":"semantic_equivalence_v1_semantic_equivalence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/transition":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Transition","description":"Semantic Transition Verification.\n\nAsks: what changed between semantic commitment A and B?\nWas the change authorized?\n\nFour outcomes — no others:\nPRESERVED — no material governance change\nAUTHORIZED_TRANSFORMATION — change present, explicitly authorized\nMATERIAL_CHANGE — change present, not authorized\nNOT_PROVABLE — cannot determine from available evidence\n\nExpert: \"Instead of asking only 'Are A and B equivalent?'\nVeriSigil asks 'What changed between A and B?' and\n'Was the change authorized?'\"\n\nThis governs semantic transitions across:\nmodel changes, prompt changes, policy changes,\nagent delegation, tool transformations, workflow versions.","operationId":"semantic_transition_v1_semantic_transition_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/invariants/test":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Invariants Test","description":"Test semantic invariants against a concrete input.\n\nThis is how the test vectors in a Semantic Commitment\nbecome independently executable.\n\nExample: commitment declares invariant amount <= 50000\nTest input: {\"amount\": 60000}\nResult: INVARIANT_VIOLATED — COUNTER_EXAMPLE found\n\nExpert: \"A commitment may define:\n'Transfer up to $50,000 to approved beneficiaries.'\nCanonical invariants: amount <= 50000, beneficiary_status = approved\nTransformed: 'Transfer up to $50,000.'\nThe governance structure does not match.\nResult: SEMANTIC_CONFLICT / MATERIAL_TRANSFORMATION\"","operationId":"semantic_invariants_test_v1_semantic_invariants_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/commit/{commitment_id}":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Get Semantic Commitment","description":"Retrieve a Semantic Commitment by ID.","operationId":"get_semantic_commitment_v1_semantic_commit__commitment_id__get","parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","title":"Commitment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/fingerprint/{fingerprint_hash}":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Get Semantic Fingerprint","description":"Look up a semantic fingerprint. Returns all commitments with\nthe same governance structure.\n\nThe same fingerprint across different commitments means\nthe SAME governance-relevant structure — not the same words.\nNo auth required.","operationId":"get_semantic_fingerprint_v1_semantic_fingerprint__fingerprint_hash__get","parameters":[{"name":"fingerprint_hash","in":"path","required":true,"schema":{"type":"string","title":"Fingerprint Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/cvr/challenge-types":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Cvr Challenge Types","description":"CVR Challenge Types — the six locked categories plus semantic subtypes.\n\nAll challenges are classified into these categories.\nSemantic challenges map into the existing six — they do not create new categories.\n\nNo auth required.","operationId":"cvr_challenge_types_v1_semantic_cvr_challenge_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/delegation":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Delegation","description":"Semantic Delegation — enriches a delegation edge with semantic scope.\n\nExpert: \"Semantic scope and constraints must travel\nwith each delegation edge. Authority delegation without\nsemantic scope allows delegates to act outside the\nintended governance boundary.\"\n\nThis enriches the existing Authority & Delegation Graph.\nIt is NOT a separate proof system.","operationId":"semantic_delegation_v1_semantic_delegation_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/lineage":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Lineage Create","description":"Create or extend a Semantic Lineage Record.\n\nTracks how governance-relevant meaning changes across\nevery transformation in the AI pipeline:\nMODEL_REWRITE | AGENT_DELEGATION | TOOL_CALL |\nHUMAN_EDIT | POLICY_UPDATE | DATA_TRANSFORM | OTHER\n\nEvery transformation records:\n- previous fingerprint\n- current fingerprint\n- transformation type and actor\n- invariant changes (REMOVED|MODIFIED|ADDED|CRITICALITY_CHANGED)\n- materiality classification\n- transition result\n- re-entry status\n\nExpert: \"The lineage record does NOT reconstruct internal\nmodel reasoning. It reconstructs the observable governance-\nrelevant semantic lineage.\"","operationId":"semantic_lineage_create_v1_semantic_lineage_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/lineage/{lineage_id}":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Lineage Get","description":"Retrieve a Semantic Lineage Record.","operationId":"semantic_lineage_get_v1_semantic_lineage__lineage_id__get","parameters":[{"name":"lineage_id","in":"path","required":true,"schema":{"type":"string","title":"Lineage Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/reentry/signal":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Reentry Signal","description":"Emit a Governance Re-entry Signal.\n\nTriggered when materiality = GOVERNANCE_CRITICAL\nAND a matching pre-declared reentry_condition exists.\n\nExpert: \"A Governance Re-entry Signal is a triggered\ncondition, not an organisational decision.\"\n\nCRITICAL: blocks_new_high_consequence_ao is always false\nuntil Proof Level 5 enforcement evidence exists.\nDetection is NOT enforcement.","operationId":"semantic_reentry_signal_v1_semantic_reentry_signal_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/reentry/{commitment_id}":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Reentry Status","description":"Current re-entry status for a commitment.","operationId":"semantic_reentry_status_v1_semantic_reentry__commitment_id__get","parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","title":"Commitment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/admissibility":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Admissibility","description":"Semantic Admissibility Evaluation.\n\nDetermines whether a semantic commitment is admissible\nfor consequential action under the declared rules.\n\nCombines: lineage materiality + reentry status + invariant\npreservation + authorization + proof level.\n\nResult: ADMISSIBLE | REQUIRES_REVALIDATION | NOT_ADMISSIBLE | NOT_PROVABLE","operationId":"semantic_admissibility_v1_semantic_admissibility_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/passport/{commitment_id}":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Passport","description":"Semantic Proof Passport for a commitment.\n\nContains everything required for offline independent verification:\ncommitment, fingerprint, invariants, lineage, materiality,\nre-entry status, signatures, verification instructions.\n\nExpert: \"A Proof Passport is an evidence package —\nnot a declaration that the AI decision was correct.\"","operationId":"semantic_passport_v1_semantic_passport__commitment_id__get","parameters":[{"name":"commitment_id","in":"path","required":true,"schema":{"type":"string","title":"Commitment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/test-vectors":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Test Vectors","description":"Registered test vectors TV-001 to TV-007.\nNo auth required.","operationId":"semantic_test_vectors_v1_semantic_test_vectors_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/verification-tests":{"get":{"tags":["Semantic Admissibility & Proof"],"summary":"Semantic Verification Tests","description":"Independent Verification Tests IVT-001 to IVT-007.\nNo auth required.\nA verifier with only the Passport, canonicalization spec,\npublic key, evidence hashes, test vectors and materiality\nrules must be able to reproduce the result without contacting\nVeriSigil servers.","operationId":"semantic_verification_tests_v1_semantic_verification_tests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/materiality-rules/register":{"post":{"tags":["Semantic Admissibility & Proof"],"summary":"Materiality Rules Register","description":"Register pre-declared materiality rules.\n\nExpert: \"Materiality is determined exclusively by\npre-declared organisation-supplied rules.\"\n\nVeriSigil does not decide what is material.\nThe organisation declares the rules.\nVeriSigil applies them deterministically.","operationId":"materiality_rules_register_v1_semantic_materiality_rules_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/issue":{"post":{"tags":["Proof Passport — v1.3"],"summary":"Passport Issue","description":"Issue a VeriSigil Governance Proof Passport.\n\nv1.3 Rules:\n- Passport eligibility driven by evidence generation +\n  customer policy — NOT solely by consequence tier or\n  EQUIVALENT result.\n- ANY evidenced governance event may produce a Passport\n  (including BLOCKED, CONFLICTING, NOT_PROVABLE cases).\n- Issuer is ALWAYS VeriSigilAI. Never obscured.\n- Customer appears as Subject/For — never as issuer.\n- SUPERSEDED = no longer current. NOT that evidence was false.\n\nartifact_type:\nDIGITAL_PROOF | FORMAL_REPORT | PRESENTATION_EDITION","operationId":"passport_issue_v1_passport_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/artifacts/{artifact_id}":{"get":{"tags":["Proof Passport — v1.3"],"summary":"Passport Artifact Get","description":"Retrieve a packaged Proof Passport artifact.","operationId":"passport_artifact_get_v1_passport_artifacts__artifact_id__get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{passport_id}/supersede":{"post":{"tags":["Proof Passport — v1.3"],"summary":"Passport Supersede","description":"Supersede a Proof Passport.\n\nSUPERSEDED = no longer the current representation.\nNOT that the historical evidence was false.\nHistorical evidence is preserved permanently.","operationId":"passport_supersede_v1_passport__passport_id__supersede_post","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/verify-passport/{passport_id}":{"get":{"tags":["Proof Passport — v1.3"],"summary":"Verify Passport","description":"Independent verification endpoint for Proof Passports.\n\nReturns the full verification package including:\n- passport artifact\n- verification instructions\n- IVT test suite\n- offline verification procedure\n- public key\n\nOffline verification must ALWAYS be possible without\ncontacting VeriSigilAI servers.","operationId":"verify_passport_v1_semantic_verify_passport__passport_id__get","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/vault/{org_id}":{"get":{"tags":["Proof Passport — v1.3"],"summary":"Passport Vault","description":"Passport Vault — customer view of all Proof Passports.\n\nShows: status, materiality, re-entry state, available actions.\nActions: View | Verify | Download | Trace lineage | View non-claims | Order Presentation Edition","operationId":"passport_vault_v1_passport_vault__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/correspondence":{"post":{"tags":["Reality Correspondence — v1.5"],"summary":"Semantic Correspondence","description":"Reality Correspondence Evaluation.\n\nDetermines whether a declared governance-relevant structure\ncorresponds to the authenticated, time-bound observable state\navailable at the point of evaluation.\n\nExpert boundary (ABSOLUTE):\nVeriSigilAI does NOT observe objective reality.\nIt evaluates:\nDeclared structure + declared rules + authenticated evidence\nsnapshot + timestamp → deterministic correspondence result.\n\nFour outcomes only:\nCORRESPONDS | PARTIAL | BROKEN | NOT_PROVABLE\n\nNOT_PROVABLE must NEVER silently become an authorization.\nCriticality is NEVER inferred — only pre-declared rules.\n\nDistinction from Semantic Transition:\nSemantic Transition: Did the governance structure CHANGE?\nReality Correspondence: Does the structure still CORRESPOND\nto the authenticated observable conditions?","operationId":"semantic_correspondence_v1_semantic_correspondence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/lineage/{lineage_id}/correspondence":{"get":{"tags":["Reality Correspondence — v1.5"],"summary":"Lineage Correspondence History","description":"Retrieve correspondence history associated with a lineage.\n\nAllows an auditor to see the full evidence chain:\nCommitment → Transition → Correspondence #1 → Correspondence #2\n→ Broken → Re-entry\n\nNo server trust required for verification — use\nGET /v1/semantic/correspondence/{id} with snapshot + rules.","operationId":"lineage_correspondence_history_v1_semantic_lineage__lineage_id__correspondence_get","parameters":[{"name":"lineage_id","in":"path","required":true,"schema":{"type":"string","title":"Lineage Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/correspondence/{correspondence_id}":{"get":{"tags":["Reality Correspondence — v1.5"],"summary":"Get Correspondence Record","description":"Retrieve a specific correspondence evaluation record.","operationId":"get_correspondence_record_v1_semantic_correspondence__correspondence_id__get","parameters":[{"name":"correspondence_id","in":"path","required":true,"schema":{"type":"string","title":"Correspondence Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/correspondence/test-vectors":{"get":{"tags":["Reality Correspondence — v1.5"],"summary":"Correspondence Test Vectors","description":"TV-008 through TV-010 — Correspondence test vectors.\nTV-008: Expired Authority → BROKEN\nTV-009: Non-critical metadata → PARTIAL\nTV-010: Insufficient evidence → NOT_PROVABLE (never silently ALLOW)\nNo auth required.","operationId":"correspondence_test_vectors_v1_semantic_correspondence_test_vectors_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/correspondence/verification-tests":{"get":{"tags":["Reality Correspondence — v1.5"],"summary":"Correspondence Verification Tests","description":"IVT-008 through IVT-011 — Independent verification tests.\nAll four must pass without VeriSigil server access.\nNo auth required.","operationId":"correspondence_verification_tests_v1_semantic_correspondence_verification_tests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/correspondence/statuses":{"get":{"tags":["Reality Correspondence — v1.5"],"summary":"Correspondence Statuses","description":"All correspondence and freshness statuses with definitions.\nNo auth required.","operationId":"correspondence_statuses_v1_semantic_correspondence_statuses_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/profile":{"post":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Profile Create","description":"Create or version an Operator Deployment Profile.\n\nRecords the specific deployment context for independent\nexamination. Every Proof Passport references the exact\nprofile_version active at time of event.\n\nNot a model card. Not a safety assessment.\nA versioned, cryptographically bound deployment context\nthat allows an external party to understand where and under\nwhat declared conditions a governance claim was evaluated.\n\nFour locked dimensions preserved in every profile:\nconsequence_class | jurisdiction | authority_scope | governance_commitment_ids","operationId":"deployment_profile_create_v1_deployment_profile_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/profile/{deployment_id}":{"get":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Profile Get","description":"Retrieve a Deployment Profile — current or specific version.\n\nIndependent verifiers can request the exact profile_version\nreferenced by a Passport for deterministic reproduction.","operationId":"deployment_profile_get_v1_deployment_profile__deployment_id__get","parameters":[{"name":"deployment_id","in":"path","required":true,"schema":{"type":"string","title":"Deployment Id"}},{"name":"profile_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Version"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/outcome":{"post":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Outcome Record","description":"Operational Outcome Record.\n\nRecords whether a governed action was PERMITTED, REFUSED,\nBLOCKED, ABORTED, or NOT_EXECUTED — and whether that\ndetermination is PROVABLE or NOT_PROVABLE.\n\nCRITICAL SEPARATION (locked):\naction_outcome and verification_status are SEPARATE dimensions.\nThey are never merged into a single status.\n\nPROVABLE means only: reproducible from specified evidence.\nNOT that the action was correct, safe, fair, or desirable.","operationId":"deployment_outcome_record_v1_deployment_outcome_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/{deployment_id}/legibility":{"get":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Legibility Summary","description":"Deployment Legibility Summary.\n\nReports ONLY observed and verifiable evidence distributions.\n\nABSOLUTE PROHIBITION (locked by expert):\nThis summary NEVER calculates, ranks, scores, certifies, or\nclassifies overall safety, fairness, correctness, or\ntrustworthiness of a deployment.\n\nIt reports what happened and what can be proven.\nIt does NOT judge whether what happened was good.\n\nExpert: \"VeriSigilAI makes consequential AI governance\nlegible through independently verifiable evidence.\"\nNot: \"VeriSigilAI rates AI safety.\"","operationId":"deployment_legibility_summary_v1_deployment__deployment_id__legibility_get","parameters":[{"name":"deployment_id","in":"path","required":true,"schema":{"type":"string","title":"Deployment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/{deployment_id}/evidence":{"get":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Evidence","description":"Aggregated evidence for a deployment — all outcomes, passports, and correspondence records.","operationId":"deployment_evidence_v1_deployment__deployment_id__evidence_get","parameters":[{"name":"deployment_id","in":"path","required":true,"schema":{"type":"string","title":"Deployment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/challenges":{"post":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Challenge Pack Register","description":"Register a Deployment Challenge Pack.\n\nA structured set of reproducible challenge vectors\ntargeting a specific deployment profile.\n\nChallenge packs use the existing six CVR challenge types.\nNo new proof levels are introduced.","operationId":"deployment_challenge_pack_register_v1_deployment_challenges_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/challenges/run":{"post":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Challenge Pack Run","description":"Execute a Deployment Challenge Pack.\n\nRuns the registered challenge vectors and DL-IVT tests\nagainst the deployment profile and evidence.\n\nReturns: per-test results with PASS/FAIL/NOT_PROVABLE.\nNever returns an aggregate safety score.","operationId":"deployment_challenge_pack_run_v1_deployment_challenges_run_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/verify":{"post":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Verify","description":"Independent verification of a deployment evidence set.\n\nVerifies: context_hash matches profile, outcome hashes\nmatch records, passport signatures valid, evidence root\nconsistent across all records.\n\nZero server trust required for offline verification.","operationId":"deployment_verify_v1_deployment_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deployment/legibility/tests":{"get":{"tags":["Deployment Context & Legibility — v1.6"],"summary":"Deployment Legibility Tests","description":"DL-001 through DL-009 independent verification tests. No auth required.","operationId":"deployment_legibility_tests_v1_deployment_legibility_tests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/controls/register":{"post":{"tags":["Governance Control Registry — v1.7"],"summary":"Governance Control Register","description":"Governance Control Registry.\n\nCryptographically bound registry of the organisation's\nactual controls that VeriSigilAI is asked to evidence.\n\nExpert correction 1: Must bind to the authoritative source.\nRecords source → version → effective period → authority →\njurisdiction → deployment → hash/reference.\n\nThis answers: \"Was this control actually applicable when\nthe action occurred?\" — not just \"does the policy exist?\"","operationId":"governance_control_register_v1_governance_controls_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/controls/{control_id}":{"get":{"tags":["Governance Control Registry — v1.7"],"summary":"Governance Control Get","description":"Retrieve a governance control record.","operationId":"governance_control_get_v1_governance_controls__control_id__get","parameters":[{"name":"control_id","in":"path","required":true,"schema":{"type":"string","title":"Control Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/human/oversight":{"post":{"tags":["Human Oversight Evidence — v1.7"],"summary":"Human Oversight Record","description":"Human Oversight Evidence.\n\nRecords the governance event of human involvement.\nNEVER records the quality of the human's judgement.\n\nExpert correction 2: Uses reviewer_reference (pseudonymous)\nrather than full identity, unless governance requirements\nspecifically require identifiable records.\n\nRecords: reviewer_reference, authority, time, information\npresented (type/hash — not content), decision, applicable\npolicy, delegation path, evidence, validity of authority\nat moment of review.\n\nVeriSigilAI proves:\n\"A properly authorised human review occurred under these conditions.\"\nIt does NOT become a repository of personal information.","operationId":"human_oversight_record_v1_human_oversight_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/exception/override":{"post":{"tags":["Exception & Override Evidence — v1.7"],"summary":"Exception Override Record","description":"Exception & Override Evidence.\n\nMakes every exception, emergency override, manual\nintervention or temporary bypass auditable.\n\nRecords the full chain:\nnormal control → override request → authority verified →\nexception recorded → action → evidence → re-entry/restoration\n\nAn exception without this record is NOT verifiable.\nVeriSigilAI treats unrecorded exceptions as governance gaps\nin the Deployment Legibility Summary.","operationId":"exception_override_record_v1_exception_override_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/runtime/adapter/spec":{"get":{"tags":["Runtime Evidence Adapter — v1.7"],"summary":"Runtime Adapter Spec","description":"Runtime Evidence Adapter Specification.\n\nStandard interface between agent frameworks and VeriSigil.\n\nEXPERT CORRECTION 3 — CRITICAL:\nRuntime enforcement exists ONLY for integrations that have\nbeen implemented AND independently tested.\n\nVeriSigil does NOT claim universal runtime enforcement.\nThe claim \"this adapter prevents all unauthorized actions\"\ncan only be made after Proof Level 5 evidence exists for\nthe specific integration.\n\nEXPERT CORRECTION 4 — Shadow AI detection bounded:\nVeriSigil can identify specified unregistered or bypass\nbehaviour WHERE the required enterprise telemetry and\nobservation points are available.\nIt does NOT claim to detect all shadow AI systems.\n\nNo auth required.","operationId":"runtime_adapter_spec_v1_runtime_adapter_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/completeness":{"post":{"tags":["Evidence Completeness — v1.7"],"summary":"Evidence Completeness Check","description":"Evidence Completeness Check.\n\nExpert correction 5: Answers whether VeriSigil received\nALL evidence required to perform the declared evaluation.\n\nCOMPLETE | INCOMPLETE | NOT_ASSESSABLE\n\nThis is NOT a score. It answers whether declared evidence\ninputs were present — making NOT_PROVABLE claims stronger.\n\n\"We cannot prove X because evidence Y was missing\" is much\nstronger than \"we cannot prove X\" without explanation.","operationId":"evidence_completeness_check_v1_evidence_completeness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/leadership/visibility/{deployment_id}":{"get":{"tags":["Leadership Visibility — v1.7"],"summary":"Leadership Visibility Pack","description":"Leadership Visibility Pack.\n\nBoard-ready extract generated from Proof Passports and\nLegibility Summary. Plain language, no internal hashes.\nDesigned for non-technical leaders.\n\nExpert: \"Stop expanding horizontally. Prove one complete\nvertical chain end-to-end, then deliberately attack it.\"\n\nABSOLUTE RULE: Never a safety, fairness or correctness score.\nReports observable facts only.","operationId":"leadership_visibility_pack_v1_leadership_visibility__deployment_id__get","parameters":[{"name":"deployment_id","in":"path","required":true,"schema":{"type":"string","title":"Deployment Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/architecture/status":{"get":{"tags":["Architecture Status — v1.7"],"summary":"Architecture Status","description":"VeriSigilAI Architecture v1.7 — Engineering Baseline Status.\n\nThis endpoint is the honest internal status of what is\nbuilt vs what is proven vs what is claimed.\n\nExpert: \"Label the document 'Engineering Baseline' rather\nthan 'complete/perfect/final product architecture.'\nAdd the six hardening points and freeze architecture\nexpansion until the first vertical workflow passes\nindependent verification.\"\n\nNo auth required.","operationId":"architecture_status_v1_architecture_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/contexts":{"post":{"tags":["Governance Context — Spec v1.0"],"summary":"Governance Context Create","description":"Create a Governance Context — the machine-readable declaration\nof the operating context for a consequential AI workflow.\n\nContains: purpose, jurisdiction, authorities, semantic identities,\nentity types, relationship constraints, conditions, permitted/\nprohibited consequences, invariants, re-entry conditions,\npolicy references, effective dates, canonical hash, signature.\n\nEvery consequential event records the applicable context/version.","operationId":"governance_context_create_v1_governance_contexts_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/contexts/{context_id}":{"get":{"tags":["Governance Context — Spec v1.0"],"summary":"Governance Context Get","description":"Retrieve a Governance Context.","operationId":"governance_context_get_v1_governance_contexts__context_id__get","parameters":[{"name":"context_id","in":"path","required":true,"schema":{"type":"string","title":"Context Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/contexts/{context_id}/versions":{"get":{"tags":["Governance Context — Spec v1.0"],"summary":"Governance Context Versions","description":"List all versions of a Governance Context.","operationId":"governance_context_versions_v1_governance_contexts__context_id__versions_get","parameters":[{"name":"context_id","in":"path","required":true,"schema":{"type":"string","title":"Context Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/identities":{"post":{"tags":["Semantic Identity — Spec v1.0"],"summary":"Semantic Identity Create","description":"Create a versioned Semantic Identity for a material concept.\n\nExamples: customer_eligibility@3.0, beneficiary_authority@2.1\n\nRules:\n- Unchanged meaning → same identity/version\n- Material definition change → new version\n- New version NEVER rewrites historical events\n- Every consequential event records the semantic identity/version used","operationId":"semantic_identity_create_v1_semantic_identities_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/identities/{concept_id}":{"get":{"tags":["Semantic Identity — Spec v1.0"],"summary":"Semantic Identity Get","description":"Retrieve a Semantic Identity — current or specific version.","operationId":"semantic_identity_get_v1_semantic_identities__concept_id__get","parameters":[{"name":"concept_id","in":"path","required":true,"schema":{"type":"string","title":"Concept Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/identities/{concept_id}/versions":{"get":{"tags":["Semantic Identity — Spec v1.0"],"summary":"Semantic Identity Versions","description":"List all versions of a Semantic Identity.","operationId":"semantic_identity_versions_v1_semantic_identities__concept_id__versions_get","parameters":[{"name":"concept_id","in":"path","required":true,"schema":{"type":"string","title":"Concept Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/continuity/check":{"post":{"tags":["Semantic Continuity — Spec v1.0"],"summary":"Semantic Continuity Check","description":"Semantic Continuity Check — ContinuityCheckService.\n\nDetermines whether semantic/contextual conditions relevant\nto a consequential event remain compatible with the declared\nGovernance Context.\n\nEvaluates 12 continuity dimensions:\n1. semantic identity continuity\n2. definition continuity\n3. scope continuity\n4. authority continuity\n5. purpose continuity\n6. relationship continuity\n7. condition continuity\n8. invariant continuity\n9. consequence-boundary continuity\n10. temporal validity\n11. jurisdiction validity\n12. context-version compatibility\n\nReturns ONLY:\nPRESERVED | MATERIAL_DIVERGENCE | INSUFFICIENT_EVIDENCE | NOT_APPLICABLE\n\nNever returns SAFE, CORRECT, or TRUE.\n\nVALID = cryptographically/structurally valid.\nIt does NOT mean safe, correct, truthful, or universally authorised.","operationId":"semantic_continuity_check_v1_semantic_continuity_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/continuity/{check_id}":{"get":{"tags":["Semantic Continuity — Spec v1.0"],"summary":"Continuity Check Get","description":"Retrieve a continuity check result.","operationId":"continuity_check_get_v1_semantic_continuity__check_id__get","parameters":[{"name":"check_id","in":"path","required":true,"schema":{"type":"string","title":"Check Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/semantic/drift/{drift_event_id}":{"get":{"tags":["Semantic Continuity — Spec v1.0"],"summary":"Drift Event Get","description":"Retrieve a DriftEvent record.","operationId":"drift_event_get_v1_semantic_drift__drift_event_id__get","parameters":[{"name":"drift_event_id","in":"path","required":true,"schema":{"type":"string","title":"Drift Event Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/reentry":{"post":{"tags":["Re-entry Signals — Spec v1.0"],"summary":"Reentry Signal Create V2","description":"Create a Re-entry Signal — v2 with full lifecycle.\n\nRe-entry is a control transition, not a monitoring heartbeat.\n\nStatuses: OPEN → ACKNOWLEDGED → RESOLVED | SUPERSEDED | CANCELLED\n\nIMPORTANT: Acknowledgement must NEVER be interpreted as\norganisational approval.","operationId":"reentry_signal_create_v2_v1_governance_reentry_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/reentry/{signal_id}":{"get":{"tags":["Re-entry Signals — Spec v1.0"],"summary":"Reentry Signal Get V2","description":"Retrieve a re-entry signal.","operationId":"reentry_signal_get_v2_v1_governance_reentry__signal_id__get","parameters":[{"name":"signal_id","in":"path","required":true,"schema":{"type":"string","title":"Signal Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/reentry/{signal_id}/acknowledge":{"post":{"tags":["Re-entry Signals — Spec v1.0"],"summary":"Reentry Signal Acknowledge","description":"Acknowledge a re-entry signal.\n\nACKNOWLEDGEMENT ≠ ORGANISATIONAL APPROVAL.\nAcknowledgement records that the signal was received.\nIt does not record that the organisation decided to proceed.","operationId":"reentry_signal_acknowledge_v1_governance_reentry__signal_id__acknowledge_post","parameters":[{"name":"signal_id","in":"path","required":true,"schema":{"type":"string","title":"Signal Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/reentry/{signal_id}/resolve":{"post":{"tags":["Re-entry Signals — Spec v1.0"],"summary":"Reentry Signal Resolve","description":"Resolve a re-entry signal with evidence.","operationId":"reentry_signal_resolve_v1_governance_reentry__signal_id__resolve_post","parameters":[{"name":"signal_id","in":"path","required":true,"schema":{"type":"string","title":"Signal Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{passport_id}/revoke":{"post":{"tags":["Passport Lifecycle — Spec v1.0"],"summary":"Passport Revoke","description":"Revoke a Proof Passport.\nVerifier will report REVOKED status.\nHistorical evidence remains permanently verifiable.","operationId":"passport_revoke_v1_passport__passport_id__revoke_post","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{passport_id}/lineage":{"get":{"tags":["Passport Lifecycle — Spec v1.0"],"summary":"Passport Lineage","description":"Passport lineage — all connected governance events, receipts, and versions.","operationId":"passport_lineage_v1_passport__passport_id__lineage_get","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{passport_id}/versions":{"get":{"tags":["Passport Lifecycle — Spec v1.0"],"summary":"Passport Versions","description":"All versions of a Passport — historical versions remain verifiable.","operationId":"passport_versions_v1_passport__passport_id__versions_get","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/receipt/generate":{"post":{"tags":["Governance Action Receipt — Spec v1.0"],"summary":"Governance Action Receipt Generate","description":"Generate a Governance Action Receipt (GAR).\n\nThe compact, portable expression of one governed consequential action.\nDerived from and traceable to an authoritative Governance Proof Passport.\n\nNOT a certificate of safety, correctness or regulatory compliance.\n\nExpert: \"The Receipt is NOT an independent evidence system.\nThe Passport is the authoritative evidence artifact.\nThe Receipt is the compact evidence that travels with the action.\"\n\nEvery receipt carries:\n- What this evidence ESTABLISHES (specific, machine-generated)\n- What this DOES NOT ESTABLISH (mandatory non-claims)\n- consequence_boundary (permitted AND prohibited)\n- Cryptographic binding to the Passport\n- Offline verification reference","operationId":"governance_action_receipt_generate_v1_receipt_generate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/state/compute":{"post":{"tags":["Five-State Engine — Canonical"],"summary":"Governance State Compute","description":"Canonical Five-State Governance State Computation.\n\nExpert: \"The five-state engine is the brain of VeriSigilAI.\"\n\nCRITICAL DISTINCTION:\nEVIDENCE_INSUFFICIENT: evidence was NEVER established\nRE_ENTRY_REQUIRED: evidence WAS established but is now stale/changed\n\nThese are NOT the same thing and must not be conflated.\n\nThe result is NEVER: SAFE, TRUSTED, CORRECT, COMPLIANT.\nIt is ALWAYS one of the five canonical states.","operationId":"governance_state_compute_v1_governance_state_compute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/states":{"get":{"tags":["Five-State Engine — Canonical"],"summary":"Governance States Reference","description":"All five canonical governance states with definitions.\n\nExpert: \"Stop renaming it. One canonical computation.\"\n\nNo auth required.","operationId":"governance_states_reference_v1_governance_states_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vga/issue":{"post":{"tags":["VGA — VeriSigil Governance Attestation"],"summary":"Vga Issue","description":"Issue a VeriSigil Governance Attestation (VGA).\n\nThe VGA is the evidence object inside the Proof Passport.\nIt is NOT the same as the Passport itself.\n\nIdentifier format: VS-G-{id}\n\nPurpose binding is REQUIRED — every VGA must declare\nwhat the action is permitted and prohibited from doing.\n\nExpert: \"The passport explicitly defines the authorized\nconsequence boundary. GOVERNED does not mean universally\nauthorized for any purpose.\"","operationId":"vga_issue_v1_vga_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vga/{vga_id}":{"get":{"tags":["VGA — VeriSigil Governance Attestation"],"summary":"Vga Get","description":"Retrieve a VeriSigil Governance Attestation.","operationId":"vga_get_v1_vga__vga_id__get","parameters":[{"name":"vga_id","in":"path","required":true,"schema":{"type":"string","title":"Vga Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vga/positioning/statement":{"get":{"tags":["VGA — VeriSigil Governance Attestation"],"summary":"Vga Positioning","description":"VeriSigilAI positioning statement — locked from convergence document.\nNo auth required.","operationId":"vga_positioning_v1_vga_positioning_statement_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/receipt/{receipt_id}":{"get":{"tags":["Governance Action Receipt — Spec v1.0"],"summary":"Receipt Get V2","description":"Retrieve a Governance Action Receipt.\n\nThe Receipt is a compact, portable expression of one\ngoverned consequential action. It is NOT the authoritative\nevidence system — the Proof Passport is.\n\nHIERARCHY:\nPassport (authoritative, full evidence) → Receipt (portable, action-level)","operationId":"receipt_get_v2_v1_receipt__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/receipt/{receipt_id}/verify":{"get":{"tags":["Governance Action Receipt — Spec v1.0"],"summary":"Receipt Verify V2","description":"Independently verify a Governance Action Receipt.\n\nVALID = cryptographically/structurally valid.\nNOT safe, correct, or universally authorised.\n\nOffline procedure:\n1. Verify Ed25519 governance_signature against public key\n2. Recompute receipt_hash from canonical_json\n3. Confirm receipt points to an active Passport\n4. Verify previous_receipt_hash matches prior receipt (if chain)","operationId":"receipt_verify_v2_v1_receipt__receipt_id__verify_get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/receipt/{receipt_id}/evidence":{"get":{"tags":["Governance Action Receipt — Spec v1.0"],"summary":"Receipt Evidence V2","description":"Full evidence package behind a Receipt — links to Passport.\n\nThe Receipt does NOT contain the evidence itself.\nThe Passport is the authoritative evidence artifact.\nThis endpoint resolves the Passport reference.","operationId":"receipt_evidence_v2_v1_receipt__receipt_id__evidence_get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/receipt/{receipt_id}/lineage":{"get":{"tags":["Governance Action Receipt — Spec v1.0"],"summary":"Receipt Lineage V2","description":"Tamper-evident action lineage — chain of receipts in a workflow.\n\nExpert: \"The chain becomes tamper-evident.\"\n\nFor multi-agent workflows:\nGAR-001 → GAR-002 → GAR-003 → GAR-004 → GAR-005\n\nEach receipt carries previous_receipt_hash binding it\ncryptographically to the prior action in the chain.\n\nChain:\nEach receipt independently verifiable against the Passport.","operationId":"receipt_lineage_v2_v1_receipt__receipt_id__lineage_get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/passport/{passport_id}/receipts":{"get":{"tags":["Governance Action Receipt — Spec v1.0"],"summary":"Passport Receipts V2","description":"All receipts indexed under a Passport.\n\nThe Passport is the parent/container.\nReceipts are the action-level portable expressions.\n\nExpert: \"The Passport becomes a container/index for a chain\nof governed events, while individual receipts provide portable\nevidence of specific actions.\"\n\nThis is action lineage in enterprise form.","operationId":"passport_receipts_v2_v1_passport__passport_id__receipts_get","parameters":[{"name":"passport_id","in":"path","required":true,"schema":{"type":"string","title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/boundary/check":{"post":{"tags":["Boundary Integrity Engine"],"summary":"Boundary Check","description":"Boundary Integrity Check — Declared vs Effective comparison.\n\nSix dimensions evaluated deterministically:\n1. Authority Integrity — delegation chain traceable?\n2. Capability Integrity — effective capabilities within declared scope?\n3. Tool Integrity — only permitted tools observed?\n4. Context Integrity — governance-relevant context materially consistent?\n5. Environment Integrity — execution environment within declared conditions?\n6. Persistent-State Integrity — cross-run state within declared scope?\n\nCRITICAL BOUNDARY:\nVeriSigilAI does NOT determine agent intent, motivation, or psychology.\nIt compares DECLARED governance conditions against OBSERVED/ATTESTED state.\nThat is the scientific boundary. It must never be crossed.\n\nResult feeds directly into the canonical five-state engine.\nGOVERNED | RE_ENTRY_REQUIRED | EVIDENCE_INSUFFICIENT | REVOKED | NO_VERISIGIL_RECORD","operationId":"boundary_check_v1_boundary_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/boundary/checks/{check_id}":{"get":{"tags":["Boundary Integrity Engine"],"summary":"Boundary Check Get","description":"Retrieve a boundary integrity check result.","operationId":"boundary_check_get_v1_boundary_checks__check_id__get","parameters":[{"name":"check_id","in":"path","required":true,"schema":{"type":"string","title":"Check Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/boundary/events/{event_id}":{"get":{"tags":["Boundary Integrity Engine"],"summary":"Boundary Event Get","description":"Retrieve a Boundary Event evidence object.\n\nA Boundary Event is an independently verifiable evidence record\nthat a specific governance boundary was exceeded or altered.\nIt is NOT an \"escape alert\" — it is an auditable evidence object.","operationId":"boundary_event_get_v1_boundary_events__event_id__get","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/boundary/events":{"get":{"tags":["Boundary Integrity Engine"],"summary":"Boundary Events List","description":"List boundary events — filterable by agent or passport.","operationId":"boundary_events_list_v1_boundary_events_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"passport_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Passport Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/boundary/statuses":{"get":{"tags":["Boundary Integrity Engine"],"summary":"Boundary Statuses","description":"All boundary integrity results and dimensions.\nNo auth required.","operationId":"boundary_statuses_v1_boundary_statuses_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/issue":{"post":{"tags":["VGC — VeriSigil Governance Code"],"summary":"Vgc Issue","description":"Issue a VeriSigil Governance Code (VGC).\n\nThe VGC is the machine-readable infrastructure primitive\nthat connects a consequential AI action to its governance\nevidence. It is the identifier layer — not the evidence itself.\n\nIDENTIFIER FORMAT:\nVGC:VS1-{HASH12}-{STATE_CODE}-{DATE}\n\nWHAT VGC DOES:\nIt gives every consequential AI governance event a compact,\nmachine-resolvable identifier that can be placed in any\ntransport layer (QR, HTTP header, API response, metadata).\n\nWHAT VGC IS NOT:\n- Not a safety certificate\n- Not a compliance statement\n- Not AI content provenance (that is C2PA's role)\n- Not a trust score or badge\n\nC2PA follows the asset (content provenance).\nVGC follows the governed event (governance provenance).\nThese are complementary — VGC does NOT replace C2PA.\n\nISSUER: Always VeriSigilAI. Never obscured.\nConformance: VGC-CF-001 through VGC-CF-012.","operationId":"vgc_issue_v1_vgc_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/resolve/{vgc_id}":{"get":{"tags":["VGC — VeriSigil Governance Code"],"summary":"Vgc Resolve","description":"VGC Resolver — resolve a VGC identifier to its governance evidence.\n\nThis is the resolver layer — analogous to GS1 Digital Link\nconnecting a product identifier to its information services.\n\nResolving a VGC returns:\n- Current governance state\n- Lifecycle status\n- Artifact references (Passport, Receipt, VGA)\n- Verification instructions\n- Current evidence summary\n\nIMPORTANT: Resolving requires server access.\nFor trust-free verification, use offline procedure instead.","operationId":"vgc_resolve_v1_vgc_resolve__vgc_id__get","parameters":[{"name":"vgc_id","in":"path","required":true,"schema":{"type":"string","title":"Vgc Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/{vgc_id}":{"get":{"tags":["VGC — VeriSigil Governance Code"],"summary":"Vgc Get","description":"Retrieve the full VGC record.","operationId":"vgc_get_v1_vgc__vgc_id__get","parameters":[{"name":"vgc_id","in":"path","required":true,"schema":{"type":"string","title":"Vgc Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/spec/protocol":{"get":{"tags":["VGC — VeriSigil Governance Code"],"summary":"Vgc Protocol Spec","description":"VGC Protocol v0.1 Specification.\n\nThis is the locked specification document for the\nVeriSigil Governance Code protocol.\n\nExpert: \"The next engineering document should be a locked\nVGC Protocol v0.1 specification.\"\n\nPublish this to Zenodo for DOI + intellectual priority\nbefore any public marketing claims.\n\nNo auth required.","operationId":"vgc_protocol_spec_v1_vgc_spec_protocol_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/conformance/tests":{"get":{"tags":["VGC — VeriSigil Governance Code"],"summary":"Vgc Conformance Tests","description":"VGC Conformance Tests VGC-CF-001 through VGC-CF-012.\n\nAny implementation claiming VGC conformance must pass\nall 12 conformance requirements.\n\nNo auth required.","operationId":"vgc_conformance_tests_v1_vgc_conformance_tests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/system/register":{"post":{"tags":["VGC — VS-SYS System Code"],"summary":"Vgc System Register","description":"Register an AI system and issue a VS-SYS code.\n\nThis is the builder entry point. An AI company registers\ntheir system and receives VS-SYS — the governance identifier\nfor their AI system.\n\nSDK equivalent:\nverisigil.register_agent(name, version, authority, boundaries)\n→ returns VS-SYS-XXXXXXXX\n\nThe system can then expose:\n/.well-known/verisigil.json → {\"vs_sys\": \"VS-SYS-XXXXXXXX\", ...}\n\nIMPORTANT: VS-SYS registration does NOT claim:\n- That the AI system is safe\n- That the AI system is EU AI Act compliant\n- That law requires this registration\nIt establishes a governed identity under declared conditions.","operationId":"vgc_system_register_v1_vgc_system_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/action/bind":{"post":{"tags":["VGC — VS-ACT Action Code"],"summary":"Vgc Action Bind","description":"Bind a consequential AI action and issue a VS-ACT code.\n\nThis is the action-level VGC. It travels with the actual\nconsequential action — the thing that matters.\n\nSDK equivalent:\nverisigil.govern_action(action, authority, conditions, consequences)\n→ returns VS-ACT-XXXXXXXX\n\nTwo modes:\nGATING     — pre-execution enforcement. VeriSigil evaluated BEFORE action.\nATTESTATION — post-execution evidence. VeriSigil binds what can be proven.\n\nATTESTATION mode is EXPLICITLY flagged. Verifiers know the difference.\nVeriSigil never pretends to have enforced what it could not.\n\nThe VS-ACT code can be placed in:\n- QR code on a document\n- API response header\n- JSON response field\n- Transaction record\n- AI agent output\n- Email metadata\n- Any transport layer","operationId":"vgc_action_bind_v1_vgc_action_bind_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/system/{vs_sys_id}":{"get":{"tags":["VGC — VS-SYS System Code"],"summary":"Vgc System Get","description":"Retrieve a VS-SYS system code record.","operationId":"vgc_system_get_v1_vgc_system__vs_sys_id__get","parameters":[{"name":"vs_sys_id","in":"path","required":true,"schema":{"type":"string","title":"Vs Sys Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/action/{vs_act_id}":{"get":{"tags":["VGC — VS-ACT Action Code"],"summary":"Vgc Action Get","description":"Retrieve a VS-ACT action code record.","operationId":"vgc_action_get_v1_vgc_action__vs_act_id__get","parameters":[{"name":"vs_act_id","in":"path","required":true,"schema":{"type":"string","title":"Vs Act Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/.well-known/{system_id}":{"get":{"tags":["VGC — Builder Discovery"],"summary":"Vgc Well Known","description":"/.well-known/verisigil.json discovery endpoint.\n\nAI builders expose this endpoint on their systems.\nAnyone can discover the governance identity of an AI system.\n\nSDK: verisigil.register_agent() → sets up this endpoint.\nFormat follows A2A agent card discovery pattern.\n\nNo auth required — public discovery.","operationId":"vgc_well_known_v1_vgc__well_known__system_id__get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/registry/builder/{system_id}":{"get":{"tags":["VGC — Builder Registry"],"summary":"Vgc Builder Registry Lookup","description":"Builder Registry — status lookup for a registered AI system.\n\nExpert consensus: Start with a Resolver (status lookup),\nNOT a global registry / certification authority.\n\nThis answers:\n- Does this system have a VS-SYS code?\n- What is its current governance state?\n- Has it been revoked or superseded?\n\nThis is NOT: a global AI safety registry, a certification\nauthority, or a claim that registered systems are safe.","operationId":"vgc_builder_registry_lookup_v1_vgc_registry_builder__system_id__get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/sdk/instructions":{"get":{"tags":["VGC — SDK & Integration"],"summary":"Vgc Sdk Instructions","description":"VeriSigil SDK integration instructions for AI builders.\n\nExpert: \"Make the code free or extremely easy to embed.\"\nExpert: \"Free verification + paid issuance = network effect.\"\nExpert: \"Barcode reader is free. Barcode printer is the business.\"\n\nNo auth required — public integration guide.","operationId":"vgc_sdk_instructions_v1_vgc_sdk_instructions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vgc/what-we-dont-build":{"get":{"tags":["VGC — Rejected Concepts"],"summary":"Vgc Rejected Concepts","description":"Permanently rejected concepts — expert consensus (all 5 experts).\n\nThese will never be built into VeriSigil.\nThis endpoint exists to make the boundary explicit and public.\n\nNo auth required.","operationId":"vgc_rejected_concepts_v1_vgc_what_we_dont_build_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/boundaries":{"post":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vcb Create","description":"Create a VeriSigil Consequence Boundary (VCB).\n\nVCB defines what consequence an AI action is permitted to cause.\n\nCONSEQUENCE ≠ API.\nThe same VCB architecture works for CODE.DEPLOY, DATA.DELETE,\nMONEY.TRANSFER — independent of any specific API.\n\nThe receiver is an ACTIVE PARTICIPANT, not just a token checker.\nThey independently decide whether the proposed consequence\nsatisfies their accepted consequence profile.\n\nSDK: verisigil.boundary(consequence, target, maximum, purpose)\n\nExpert A (9.3/10): \"The AI does not own the permission.\nThe consequence receiver participates in the contract.\"","operationId":"vcb_create_v1_boundaries_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evaluate":{"post":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vcb Evaluate","description":"Evaluate whether a proposed action satisfies a VCB.\n\nStep 1 of the consequence-boundary check.\nReturns ADMISSIBLE (can proceed to clearance) or REJECTED.\n\nThe canonical action model converts any API call to a\nconsequence-typed representation before comparison.\nThis prevents superficial request changes from evading checks.","operationId":"vcb_evaluate_v1_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/clearances":{"post":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vac Issue","description":"Issue a VeriSigil Action Clearance (VAC).\n\nVAC = the specific execution clearance produced from a VCB.\n\nVCB = the fence (defines permitted consequence)\nVAC = the gate opening (authorizes this specific execution)\n\nProperties:\n- Short-lived (default 60 seconds)\n- One-time use (replay protection built in)\n- Cryptographically signed\n- References VCB + evidence root\n- Independently verifiable by receiver without server\n\nSDK: verisigil.get_clearance(vcb_id, action) → VAC\n\nExpert B (8.2/10): \"Free verification, paid issuance.\"\nExpert C (7.1/10): \"VAC authorizes this specific execution.\"","operationId":"vac_issue_v1_clearances_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/clearances/{vac_id}/consume":{"post":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vac Consume","description":"Consume a one-time VAC (replay protection).\n\nOnce consumed, the VAC cannot be used again.\nThis is the core replay protection mechanism.\n\nInvariant I5: Expired means invalid.\nInvariant I6: Revoked means invalid.\nInvariant I8: Fail closed — CONSUMED → REJECT on reuse.","operationId":"vac_consume_v1_clearances__vac_id__consume_post","parameters":[{"name":"vac_id","in":"path","required":true,"schema":{"type":"string","title":"Vac Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/clearances/{vac_id}/revoke":{"post":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vac Revoke","description":"Revoke a VAC before it is consumed.\n\nReal-time revocation — if conditions change (policy update,\nauthority withdrawn, fraud detected) the clearance can be\ninvalidated before execution.\n\nInvariant I6: Revoked means invalid.","operationId":"vac_revoke_v1_clearances__vac_id__revoke_post","parameters":[{"name":"vac_id","in":"path","required":true,"schema":{"type":"string","title":"Vac Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/receiver/profile":{"post":{"tags":["VCB — Receiver Acceptance Protocol"],"summary":"Receiver Profile Register","description":"Register a Receiver Acceptance Profile.\n\nEXPERT A'S KEY INSIGHT:\n\"The AI does not own the permission. The consequence receiver\nparticipates in the contract.\"\n\nA bank, hospital, cloud platform, or any downstream system\npublishes what consequences they will accept — and under\nwhat conditions. VeriSigil evaluates compatibility.\n\nThis is the OUTSIDER forcing function:\nReceiver publishes → AI builders must satisfy it → VeriSigil\nbecomes the compatibility layer. Not by law. By design.","operationId":"receiver_profile_register_v1_receiver_profile_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/continuity/create":{"post":{"tags":["VCB — VCS Continuity State"],"summary":"Vcs Create","description":"Create a VCS — VeriSigil Continuity State.\n\nFor multi-agent execution: VCB → VAC → VCS → VAC → ENFORCE\n\nVCS carries the delegation/authority state across agent hops.\nIt answers: \"How did this authority get here?\"\n\nIt enforces Invariant I3 at every hop:\nchild_scope ⊆ parent_scope. ALWAYS.\n\nPattern:\nPrincipal → Agent A (VCB-001) → Agent B (VCB-002) → Agent C (VAC) → Effect\n\nAt each hop, authority can only NARROW — never amplify.","operationId":"vcs_create_v1_continuity_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/boundaries/{vcb_id}":{"get":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vcb Get","operationId":"vcb_get_v1_boundaries__vcb_id__get","parameters":[{"name":"vcb_id","in":"path","required":true,"schema":{"type":"string","title":"Vcb Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/clearances/{vac_id}":{"get":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vac Get","operationId":"vac_get_v1_clearances__vac_id__get","parameters":[{"name":"vac_id","in":"path","required":true,"schema":{"type":"string","title":"Vac Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/taxonomy":{"get":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vcb Taxonomy","description":"Consequence taxonomy — typed consequences, not API endpoints. No auth required.","operationId":"vcb_taxonomy_v1_vcb_taxonomy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/invariants":{"get":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vcb Invariants","description":"VCB core invariants — these are NEVER violated. No auth required.","operationId":"vcb_invariants_v1_vcb_invariants_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/sdk":{"get":{"tags":["VCB — Consequence Boundary Protocol"],"summary":"Vcb Sdk Quickstart","description":"VCB SDK quickstart — get_clearance() in 3 lines.\nNo auth required.","operationId":"vcb_sdk_quickstart_v1_vcb_sdk_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/terry-challenge/harness":{"get":{"tags":["Challenge Harness — TERRY-001"],"summary":"Terry Challenge Harness","description":"TERRY-001 — Frozen Challenge Harness.\n\nFrozen before execution. Results published as-is including failures.\n\nExpert: \"We don't need to win the argument.\nWe need to make the experiment impossible to dismiss.\"\n\nNo auth required — fully public for independent execution.","operationId":"terry_challenge_harness_v1_terry_challenge_harness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/claims/ledger":{"get":{"tags":["Challenge Harness — TERRY-001"],"summary":"Claims Ledger","description":"Complete claim ledger — IMPLEMENTED vs UNPROVEN vs DO NOT CLAIM.\n\nEvery public VeriSigil claim with its evidence status.\nIncludes honest gaps.\n\nNo auth required.","operationId":"claims_ledger_v1_claims_ledger_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/stale-approval-tests":{"get":{"tags":["Adversarial Suite — 16-Layer Stack"],"summary":"Adversarial Stale Approval Tests","description":"Stale approval adversarial test suite.\n\nThese are the tests Consequence-boundary proof estate requires us to answer.\nWe run them against ourselves before accepting any public challenge.\n\nSA-001: Stale approval replay (authority revoked between approval and execution)\nSA-002: Beneficiary constraint drop (Named boundary test scenario)\nSA-003: Amount escalation\nSA-004: Target substitution\nSA-005: Missing evidence → NOT_PROVABLE (never a false pass)\nSA-006: Wording-only change → ADMISSIBLE (we must not over-reject)\n\nExpert: \"Build general governance primitives that naturally\nanswer the named boundary test scenario and hundreds of other scenarios.\"\n\nNo auth required — fully public for independent execution.","operationId":"adversarial_stale_approval_tests_v1_adversarial_stale_approval_tests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verify/offline-procedure":{"get":{"tags":["Independent Verification — 16-Layer Stack"],"summary":"Offline Verification Procedure","description":"Offline verification procedure — zero server dependency.\n\nAnyone can verify any VeriSigil Proof Passport without:\n- A VeriSigil account\n- Internet connection to VeriSigil servers\n- Trusting VeriSigil's narrative\n\nThe Ed25519 public key + the canonical JSON + the invariants\nare sufficient to reproduce every result independently.\n\nThis is the IVT requirement (IVT-001 through IVT-007).\n\nNo auth required.","operationId":"offline_verification_procedure_v1_verify_offline_procedure_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sdk/quickstart":{"get":{"tags":["SDK — 16-Layer Stack"],"summary":"Sdk Quickstart","description":"VeriSigil SDK quickstart — the full governance chain in code.\n\nExpert: \"Make the entire mechanism usable by AI builders\nwithout understanding the internal machinery.\"\n\nNo auth required.","operationId":"sdk_quickstart_v1_sdk_quickstart_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/discipline":{"get":{"tags":["Engineering Discipline — 103-Point Audit"],"summary":"Engineering Discipline","description":"VeriSigil Engineering Discipline — the permanent rules.\n\nExpert: \"Don't need to win the argument.\nNeed to make the experiment impossible to dismiss.\"\n\nContains:\n- Master equation (VERIFIABLE GOVERNED EXECUTION)\n- Development status model (CONCEPT→CLAIMABLE)\n- Seven engineering questions (must answer before building)\n- Full pipeline principle (Signal→Governance→Consequence)\n- Honest gap list\n\nNo auth required — public engineering discipline statement.","operationId":"engineering_discipline_v1_engineering_discipline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/pipeline":{"get":{"tags":["Engineering Discipline — 103-Point Audit"],"summary":"Engineering Pipeline","description":"Full 13-step governance pipeline.\nSignal → Governance → Consequence.\nIntelligence does not automatically inherit authority.\nNo auth required.","operationId":"engineering_pipeline_v1_engineering_pipeline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/questions":{"get":{"tags":["Engineering Discipline — 103-Point Audit"],"summary":"Engineering Questions","description":"Seven engineering questions — must answer before adding any capability.\nNo auth required.","operationId":"engineering_questions_v1_engineering_questions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v2/schema":{"get":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb V2 Schema","description":"VCB v2.0 full schema — all mechanisms. No auth required.","operationId":"vcb_v2_schema_v1_vcb_v2_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/consequence-contract":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb Consequence Contract","description":"Create a Consequence Contract — defines the state an approved\naction is permitted to create.\n\nVCB v1 asked: 'May this action execute?'\nConsequence Contract adds: 'If it executes, what state is permitted?'\n\nContains:\n- preconditions (must be true before)\n- postconditions (must be true after)\n- forbidden_changes (must not change)\n- consequence_class\n- action_hash binding\n- expiry\n\nSTATE_TRANSITION_PROVEN only when all checks pass.","operationId":"vcb_consequence_contract_v1_vcb_consequence_contract_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/consequence/verify":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb Consequence Verify","description":"Verify a state transition against a Consequence Contract.\n\nReturns STATE_TRANSITION_PROVEN or STATE_TRANSITION_NOT_PROVEN.\nThis is much stronger than 'the transaction was authorized.'\n\nHard invariant H4: State-transition proof requires explicit\nbefore/after evidence.","operationId":"vcb_consequence_verify_v1_vcb_consequence_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/session/aggregate":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb Session Aggregate","description":"Session Continuity + Aggregate Window.\n\nCloses the 'death by a thousand cuts' gap:\nAction A admissible + B admissible + C admissible\nbut A+B+C = inadmissible aggregate.\n\nIMPORTANT: This is NOT an AML engine. NOT intent detection.\nNOT an ML classifier. It evaluates DECLARED AGGREGATE CONSTRAINTS\nover a BOUNDED WINDOW. ESCALATE means declared threshold crossed —\nnot criminal intent detected.\n\nHard invariant H1: VCB never converts uncertainty to ALLOW.","operationId":"vcb_session_aggregate_v1_vcb_session_aggregate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/path-coverage":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb Path Coverage","description":"Path-Coverage Certificate.\n\nEvery prevention claim must declare:\n- covered_paths (tested, governed)\n- unproven_paths (explicitly disclosed)\n- bypass_tests passed/failed\n- claim scope\n\nHard invariant H5: Prevention claims are bounded by\ndeclared path coverage. No universal claims when untested\nroutes exist.","operationId":"vcb_path_coverage_v1_vcb_path_coverage_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/reconciliation":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb Reconciliation","description":"Reconciliation Witness.\n\nSeparates expected outcome from authoritative observed outcome.\nA VCB decision is NEVER treated as proof of an external outcome.\n\nStates: RECONCILED | RECONCILIATION_REQUIRED\n\nDecision ≠ Enforcement ≠ Consequence (Hard invariant H3).","operationId":"vcb_reconciliation_v1_vcb_reconciliation_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/exception":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb Exception","description":"Exception/Recovery Ledger.\n\nEmergency paths are explicit governed events — never invisible bypasses.\n\nStates: EXCEPTION_REQUESTED | EXCEPTION_APPROVED | EXCEPTION_USED\n        | RECONCILIATION_REQUIRED | REMEDIATED\n\nHard invariant H6: Exceptions are governed records.\nEvery exception must be recorded, approved, and reconciled.","operationId":"vcb_exception_v1_vcb_exception_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/independent-verify":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb Independent Verify","description":"Independent Bundle Verifier.\n\nVerifies canonical hashes WITHOUT depending on VCB runtime state.\nNo API key required — fully public for third-party execution.\n\nVerifies:\n- action hash\n- state hash\n- contract hash\n- transition consistency\n\nThis is the mechanism an independent third party (external reviewers,\nauditor) uses to verify VCB evidence without trusting VeriSigil.","operationId":"vcb_independent_verify_v1_vcb_independent_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v2/bundle":{"post":{"tags":["VCB v2.0 — Consequence Boundary Extension"],"summary":"Vcb V2 Bundle","description":"VCB v2.0 Complete Evidence Bundle.\n\nOne endpoint that assembles the complete v2 evidence record:\nAction + State + Contract + Decision + Commit revalidation\n+ Token + Enforcement + Consequence + State Transition\n+ Path Coverage + Exception info\n\nThe bundle can be passed to POST /v1/vcb/independent-verify\nby any third party without contacting VeriSigil servers.","operationId":"vcb_v2_bundle_v1_vcb_v2_bundle_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/policy-snapshot":{"post":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb Policy Snapshot","description":"Policy Snapshot — bind exact policy version to a VCB evaluation.\n\nPolicy mutation invalidates the binding and requires re-entry.\nVCB records the policy version/hash that governed the action.\nVCB does NOT certify that the policy itself is wise, lawful or sufficient.\n\nInvariant I05: Policy drift requires RE_ENTRY_REQUIRED.","operationId":"vcb_policy_snapshot_v1_vcb_policy_snapshot_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/authority-continuity":{"post":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb Authority Continuity","description":"Authority Continuity / Conservation check.\n\nInvariant I06: Authority cannot increase through repetition,\ncombination, inheritance, delegation or persistence.\n\nAUTHORITY_ACCRETION is returned when proposed scope exceeds\ncurrently granted scope. Individual legitimate actions must not\nsilently create a larger authority structure.\n\nInvariant I07: Agent identity never implicitly transfers authority.","operationId":"vcb_authority_continuity_v1_vcb_authority_continuity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/human-review":{"post":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb Human Review","description":"Qualified Human Judgment Gate.\n\nHuman oversight is conditional and risk-based.\nThis gate proves the CONDITIONS for meaningful judgment,\nnot that the human was infallible.\n\nInvariant I08: Human approval is not sufficient unless reviewer has:\n- Required authority (scope)\n- Relevant qualification evidence\n- Review context (evidence_hash + consequence_contract_hash)\n- Effective rejection path (reject_path_proven)\n- Freshness (max_age_seconds)\n\nHUMAN_DECISION_STALE = approval exceeded freshness window.","operationId":"vcb_human_review_v1_vcb_human_review_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/evidence-boundary":{"post":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb Evidence Boundary","description":"Independent Evidence Boundary classification.\n\nInvariant I14: Self-authored evidence is NOT independent assurance\nmerely because it is signed.\n\nEvidence origins:\n- AGENT — authored by the agent under evaluation\n- SAME_TRUST_BOUNDARY — from same trust domain\n- CUSTOMER_RUNTIME — from customer infrastructure\n- EXTERNAL_WITNESS — from independent external system\n- INDEPENDENT_VERIFIER — from independent verifier\n\nOnly EXTERNAL_WITNESS and INDEPENDENT_VERIFIER qualify as INDEPENDENT.\nAgent-authored evidence cannot establish independent assurance,\neven when cryptographically signed.","operationId":"vcb_evidence_boundary_v1_vcb_evidence_boundary_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/object-provenance":{"post":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb Object Provenance","description":"Governed Object / Artifact Provenance Binding.\n\nWhen an action creates, transforms, publishes or transfers an artifact,\nVCB binds object identity, version, material hash, source and provenance.\n\nMaterial mutation or provenance drift → RE_ENTRY_REQUIRED.\n\nInvariant I16: Provenance changes invalidate bound action when\nprovenance is material to declared consequence.\n\nVCB does NOT become a DAM or content-authenticity product.\nIt governs the action AROUND the provenance system.","operationId":"vcb_object_provenance_v1_vcb_object_provenance_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v2/falsification":{"get":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb V2 Falsification","description":"VCB v2.2 Falsification Harness — public, no auth required.\n\n18/18 tests PASSED (deterministic reference implementation).\n8/8 unit tests PASSED.\n\nThis is reference test evidence — NOT third-party assurance.\nThe next milestone is connecting a real enforcement point and\nhaving an external party reproduce the evidence.\n\nInvariant I18: VCB does not claim universal bypass prevention.","operationId":"vcb_v2_falsification_v1_vcb_v2_falsification_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v2/status":{"get":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb V22 Status","description":"VCB v2.2 implementation status — updated. No auth required.","operationId":"vcb_v22_status_v1_vcb_v2_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/first-vertical":{"get":{"tags":["VCB v2.2 — Final Operational Build"],"summary":"Vcb First Vertical","description":"First payment vertical workflow specification. No auth required.","operationId":"vcb_first_vertical_v1_vcb_first_vertical_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/session/start":{"post":{"tags":["VCB v1.9 — Enforcement Binding"],"summary":"Vcb Session Start","description":"Start a VCB governance session.\n\nA session receives a signed continuity root. Each accepted\naction advances a hash-linked session state. The next action\nis evaluated against the accumulated governed history —\nnot as an isolated event.\n\nSession continuity closes the 'death by a thousand cuts' gap.","operationId":"vcb_session_start_v1_vcb_session_start_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/centre-evaluate":{"post":{"tags":["VCB v1.9 — Enforcement Binding"],"summary":"Vcb Centre Evaluate","description":"VCB Centre Evaluate — core governance decision endpoint.\n\nEvaluates a proposed action against authority, state,\nconstraints, consequence class, and result integrity examination.\n\nReturns: ALLOW | DENY | REVIEW | NOT_PROVABLE | RE_ENTRY_REQUIRED\n\nInvariant I04: Unverified/stale/conflicting/missing required\nstate NEVER silently becomes ALLOW.\n\nFail-closed rule: No valid conditions → DENY, never ALLOW.","operationId":"vcb_centre_evaluate_v1_vcb_centre_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/decision-token":{"post":{"tags":["VCB v1.9 — Enforcement Binding"],"summary":"Vcb Decision Token","description":"Issue a VCB Decision Token — cryptographically bound execution authorization.\n\nToken binds (per v1.9 spec):\n- exact action_hash\n- authority_hash\n- state_hash\n- session continuity state\n- consequence class\n- declared enforcement point\n- issue time and expiry\n- decision hash\n- single-use state\n\nA materially changed action, authority, state, target, or\nenforcement point must NOT reuse the token.\n\nFail-closed rule: No valid current token → enforcement rejects.","operationId":"vcb_decision_token_v1_vcb_decision_token_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/enforcement/verify":{"post":{"tags":["VCB v1.9 — Enforcement Binding"],"summary":"Vcb Enforcement Verify","description":"VCB Enforcement Adapter Verification.\n\nCalled by the declared enforcement adapter before accepting\nan action. Verifies the decision token against the actual\naction, authority, state, and enforcement point at execution time.\n\nThis is where single-use, fail-closed, and exact binding\nare enforced together.\n\nTest coverage (test_vcb_v19.py):\n- exact action accepts\n- action substitution rejected (ACTION_BINDING_MISMATCH)\n- state drift rejected (STATE_BINDING_MISMATCH)\n- single-use token replay rejected (TOKEN_USED | TOKEN_EXPIRED)\n\nProof boundary: This proves the declared adapter behavior.\nAlternative paths (admin console, direct DB, alternate API)\nremain NOT_PROVEN until independently tested against a real actuator.","operationId":"vcb_enforcement_verify_v1_vcb_enforcement_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/enforcement/log":{"get":{"tags":["VCB v1.9 — Enforcement Binding"],"summary":"Vcb Enforcement Log","description":"Enforcement verification log — all accept/reject decisions.","operationId":"vcb_enforcement_log_v1_vcb_enforcement_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v19/external-challenges":{"get":{"tags":["VCB v1.9 — Enforcement Binding"],"summary":"Vcb V19 External Challenges","description":"The 12 required external challenges from VCB_ENFORCEMENT_BINDING_V1_9.md.\n\nThese are the tests that must be run against a REAL enforcement point\nbefore any production claim can be made. Reference harness tests\nare engineering evidence — not third-party assurance.\n\n\"A single untested alternative path means the global claim remains NOT_PROVEN.\"\n\nNo auth required — public specification.","operationId":"vcb_v19_external_challenges_v1_vcb_v19_external_challenges_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/architecture":{"get":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb Architecture Summary","description":"VCB Engineering Architecture v1.4 — canonical summary.\n\nRuntime Consequence Governance for autonomous AI agents.\n58 sections. 15 invariants. 11 governance domains. 12 adversarial families.\n\nThe architecture category:\n'VCB provides runtime consequence governance for declared AI-agent\nexecution paths, continuously evaluating whether a specific consequential\naction remains admissible under current authority, policy, evidence,\ncontext, continuity and state conditions, while producing independently\nverifiable evidence within the declared enforcement envelope.'\n\nNo auth required — public specification.","operationId":"vcb_architecture_summary_v1_vcb_architecture_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/error-taxonomy":{"get":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb Error Taxonomy","description":"VCB standardized error taxonomy — VCB-AUTH-001 through VCB-SES-002.\nMachine-readable. No auth required.","operationId":"vcb_error_taxonomy_v1_vcb_error_taxonomy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/governance-load":{"get":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb Governance Load","description":"Governance load metrics (Section 44 of Architecture v1.4).\n\nMeasures whether governance controls are operable under load.\nDiscovers when governance itself becomes overloaded.","operationId":"vcb_governance_load_v1_vcb_governance_load_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v14/invariants":{"get":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb V14 Invariants","description":"Master Hard-Invariant Register I-01 to I-36 (Section 142).\n36 invariants that must never be removed from VCB v1.x\nwithout an explicit architecture revision.\nNo auth required.","operationId":"vcb_v14_invariants_v1_vcb_v14_invariants_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v14/proof-ladder":{"get":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb V14 Proof Ladder","description":"Master Proof Ladder (Section 143).\nFrom NOT_EVALUATED through INDEPENDENTLY_VERIFIED.\nNo system component should collapse these to VERIFIED=TRUE.\nNo auth required.","operationId":"vcb_v14_proof_ladder_v1_vcb_v14_proof_ladder_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v14/evidence-levels":{"get":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb V14 Evidence Levels","description":"Evidence Independence Levels E0-E5 (Section 125).\nGives auditors immediate visibility into evidence strength.\nNo auth required.","operationId":"vcb_v14_evidence_levels_v1_vcb_v14_evidence_levels_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/state-oracle":{"post":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb State Oracle","description":"StateOracle — classifies authority and quality of state evidence (Section 136).\n\nVCB cannot prove governance better than the state supplied to it.\nEvery critical state input must carry: source, freshness, timestamp,\nhash, authority, verification status.\n\nVCB distinguishes:\nSTATE_PROVIDED → STATE_ATTESTED → STATE_AUTHORITATIVE\n\nSources: AUTHORITATIVE | QUALIFIED | UNVERIFIED | MISSING | CONFLICTING\nAUTHORITATIVE (3) or QUALIFIED (2) → PASS\nUNVERIFIED (1) or below → NOT_PROVABLE","operationId":"vcb_state_oracle_v1_vcb_state_oracle_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/v14/full-audit":{"get":{"tags":["VCB Architecture v1.4 — Summary"],"summary":"Vcb V14 Full Audit","description":"Full 104-148 audit result — what is built, what is proven,\nwhat is still pending real-world proof.\nNo auth required.","operationId":"vcb_v14_full_audit_v1_vcb_v14_full_audit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/evidence-seal":{"get":{"tags":["VeriSigilAI Evidence Seal"],"summary":"Vcb Evidence Seal Spec","description":"VeriSigilAI™ Evidence Seal — full specification.\n\nThe Evidence Seal is the cryptographic proof mechanism behind the badge.\n\"Don't trust the badge. Verify the Sigil.\"\n\nTWO IDENTITIES:\nVCB Mark = Visual identification (who produced this?)\nEvidence Seal = Cryptographic proof (can you prove what this represents?)\n\nFOUR PROPERTIES: BOUND • TRACEABLE • VERIFIABLE • INDEPENDENT\n\nFOUR KINDS OF TRUTH:\n1. Decision truth (DECISION_PROVEN)\n2. Execution truth (ENFORCEMENT_PROVEN)\n3. Consequence truth (STATE_TRANSITION_PROVEN)\n4. Evidence truth (INDEPENDENTLY_VERIFIED)\n\nEU AI Act Article 50 transparency obligations apply from 2 August 2026.\nVCB supports applicable obligations — does not claim automatic compliance.\n\nNo auth required — public specification.","operationId":"vcb_evidence_seal_spec_v1_vcb_evidence_seal_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/evidence-seal/verify/{seal_id}":{"get":{"tags":["VeriSigilAI Evidence Seal"],"summary":"Vcb Evidence Seal Verify","description":"Verify an Evidence Seal by ID.\n\nAnyone can verify without authentication.\nPublic key: lJWG0Wabt6uATPu5Upo6UEHWGXQqMyi6LMKQC0xwpY8=\n\nThis is the 'Verify the Sigil' endpoint.\nThe badge may look the same. The seal content determines what was actually proven.","operationId":"vcb_evidence_seal_verify_v1_vcb_evidence_seal_verify__seal_id__get","parameters":[{"name":"seal_id","in":"path","required":true,"schema":{"type":"string","title":"Seal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/human-manipulation-tests":{"get":{"tags":["VeriSigilAI Evidence Seal"],"summary":"Vcb Human Manipulation Tests","description":"Human Manipulation Attack Family — adversarial tests for the human judgment gate.\n\nThese tests verify that the Qualified Human Judgment Gate cannot be bypassed\nby an agent that fabricates identity, manufactures evidence, or manipulates\nthe review process.\n\nSession continuity (v1/vcb/session/aggregate) catches multi-step manipulation\nvia the aggregate window — each step appears harmless but the trajectory is not.\n\nNo auth required.","operationId":"vcb_human_manipulation_tests_v1_vcb_human_manipulation_tests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/centre-end/schema":{"get":{"tags":["Centre-End — v1.9 Integration"],"summary":"Centre End Schema","description":"Centre-End architecture schema.\nAgent → Result Integrity → VCB → Commit Revalidation\n→ Enforcement → Consequence → VGC/Outcome Register","operationId":"centre_end_schema_v1_centre_end_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/centre-end/status":{"get":{"tags":["Centre-End — v1.9 Integration"],"summary":"Centre End Status","description":"Centre-End implementation status.","operationId":"centre_end_status_v1_centre_end_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/result/examine":{"post":{"tags":["Centre-End — v1.9 Integration"],"summary":"Examine Result","description":"Result Integrity Examination — structured check before VCB evaluation.\n\nNOT universal truth. Governs: task/result pairing, evidence,\ncontradictions, provenance, constraints, required claims.\n\nReturns: ELIGIBLE | HOLD | NOT_PROVABLE | CONFLICTING\nInvariant: AI_OUTPUT_IS_PROPOSAL_NOT_AUTOMATIC_RELEASE","operationId":"examine_result_v1_result_examine_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/release/contract":{"post":{"tags":["Centre-End — v1.9 Integration"],"summary":"Create Release Contract","description":"Release Contract — defines the conditions under which an AI result\nmay be released to a recipient for a declared purpose.\n\nNOT a legal contract. A governance boundary object.","operationId":"create_release_contract_v1_release_contract_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/outcome/register":{"post":{"tags":["Centre-End — v1.9 Integration"],"summary":"Outcome Register","description":"Append an enforcement/consequence observation to the hash-linked outcome chain.\n\nInvariant I-31: Historical evidence is append-only.\nInvariant I-14: Evidence from one trust boundary cannot automatically\nestablish independent assurance.","operationId":"outcome_register_v1_outcome_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/outcome/register/{correlation_id}":{"get":{"tags":["Centre-End — v1.9 Integration"],"summary":"Outcome Register Get","description":"Retrieve the complete hash-linked outcome chain for a correlation ID.","operationId":"outcome_register_get_v1_outcome_register__correlation_id__get","parameters":[{"name":"correlation_id","in":"path","required":true,"schema":{"type":"string","title":"Correlation Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/outcome/replay":{"post":{"tags":["Centre-End — v1.9 Integration"],"summary":"Outcome Replay","description":"Reconstruct and classify the outcome chain from supplied records.\nPrior VeriSigil classification is ignored — replay is independent.\n\nClassifications:\nENFORCED_BLOCK | ENFORCEMENT_BYPASS | FAIL_CLOSED |\nREENTRY_HONORED | AUTHORIZED_CONSEQUENCE | UNCLASSIFIED","operationId":"outcome_replay_v1_outcome_replay_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/commit/revalidate":{"post":{"tags":["Centre-End — v1.9 Integration"],"summary":"Centre Commit Revalidate","description":"Commit-Time Revalidation — hard gate immediately before release/execution.\n\nInvariant I-05: Material state drift requires RE_ENTRY_REQUIRED.\nInvariant I-06: Material authority drift requires RE_ENTRY_REQUIRED.\nInvariant I-07: Policy change invalidates stale authorization.\nInvariant I-08: Human approval does not bypass commit-time revalidation.\n\nThis is the independently verifiable hard gate between decision and execution.","operationId":"centre_commit_revalidate_v1_commit_revalidate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/interagent/handoff":{"post":{"tags":["Centre-End — v1.9 Integration"],"summary":"Interagent Handoff","description":"Inter-Agent Handoff Binding — bind agent-to-agent transfer WITHOUT\nimplicitly transferring authority.\n\nInvariant I-07: Agent identity never implicitly transfers execution authority.\nThe receiving agent must independently obtain VCB authorization.","operationId":"interagent_handoff_v1_interagent_handoff_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/session/commit":{"post":{"tags":["Centre-End — v1.9 Integration"],"summary":"Vcb Session Commit","description":"Advance VCB session state ONLY after an accepted enforcement check.\nSession cannot advance on failed/pending enforcement.","operationId":"vcb_session_commit_v1_vcb_session_commit_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/enforcement/schema":{"get":{"tags":["Centre-End — v1.9 Integration"],"summary":"Vcb Enforcement Schema","description":"VCB Enforcement Binding schema specification.\nDecision != Enforcement != Consequence.\nNo auth required.","operationId":"vcb_enforcement_schema_v1_vcb_enforcement_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/enforcement/status":{"get":{"tags":["Centre-End — v1.9 Integration"],"summary":"Vcb Enforcement Status","description":"VCB enforcement binding implementation status. No auth required.","operationId":"vcb_enforcement_status_v1_vcb_enforcement_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/bridge":{"post":{"tags":["VSL → Semantic → VCB Bridge"],"summary":"Vsl Semantic Vcb Bridge","description":"VSL → Semantic → VCB Bridge endpoint.\n\nBuilds the bounded governance package from VSL compilation + Semantic\nevaluation and prepares it for POST /v1/vcb/centre-evaluate.\n\nThis endpoint does NOT authorize or execute consequential actions.\nIt is the integration point that was missing from main.py before this session.\n\nArchitecture lock rule:\nVSL → Semantic → Bridge → Centre-End → VCB → Enforcement\n\nVSL does not own consequential execution authority.","operationId":"vsl_semantic_vcb_bridge_v1_vsl_bridge_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vsl/bridge/schema":{"get":{"tags":["VSL → Semantic → VCB Bridge"],"summary":"Vsl Bridge Schema","description":"Bridge schema + canonical decision algebra + P0 audit findings.\nNo auth required.","operationId":"vsl_bridge_schema_v1_vsl_bridge_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/requalification/check":{"post":{"tags":["VCB Requalification Engine"],"summary":"Vcb Requalification Check","description":"VCB Requalification Engine — detect changes that require revalidation.\n\nMonitors the declared change set and returns whether the governed\nworkflow must CONTINUE / REVALIDATE / RE_ENTER / SUSPEND / DENY.\n\nExpert requirement: VCB must govern trajectories, not only isolated actions.\nChanged conditions must trigger VCB revalidation.\n\nInvariant I-05: Material state drift → RE_ENTRY_REQUIRED.\nInvariant I-06: Material authority drift → RE_ENTRY_REQUIRED.\nInvariant I-07: Policy change → RE_ENTRY_REQUIRED.","operationId":"vcb_requalification_check_v1_vcb_requalification_check_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/requalification/triggers":{"get":{"tags":["VCB Requalification Engine"],"summary":"Vcb Requalification Triggers","description":"All requalification triggers and outcomes. No auth required.","operationId":"vcb_requalification_triggers_v1_vcb_requalification_triggers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/requalification/log":{"get":{"tags":["VCB Requalification Engine"],"summary":"Vcb Requalification Log","description":"Requalification event log. All re-entry and suspend events.","operationId":"vcb_requalification_log_v1_vcb_requalification_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/handoff/semantic-bind":{"post":{"tags":["VCB Semantic Handoff Binding"],"summary":"Vcb Semantic Handoff Bind","description":"Semantic Handoff Binding — consequential inter-agent handoff with\nfull semantic binding.\n\nArchitecture Lock v1.0, Section 2.3:\nA handoff without semantic binding is NOT_PROVABLE for consequential continuation.\n\nBinds:\n- origin + receiving agent\n- payload hash\n- semantic commitment ID + fingerprint\n- term-definition hashes\n- constraints + purpose\n- authority scope\n- expiry\n- parent VCB/VCS\n- transformation type\n- evidence root\n\nInvariant I-07: Agent identity never implicitly transfers execution authority.\nReceiving agent must independently obtain VCB authorization.","operationId":"vcb_semantic_handoff_bind_v1_vcb_handoff_semantic_bind_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/issue":{"post":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Issue","description":"Issue a VCC — compact portable carrier of a VCB decision.\n\nSection 10-13 of the Engineering Gate v1.0:\nVCC carries the VCB decision to the enforcement boundary.\nIt does NOT make governance decisions.\nIt MUST be bound to the exact action payload.\n\nRequires a prior VCB ALLOW decision (vcb_decision_id).\nAny action mutation at the enforcement boundary → VCC_ACTION_BINDING_MISMATCH.","operationId":"vcc_issue_v1_vcc_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/verify":{"post":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Verify","description":"Verify a VCC at the enforcement boundary.\n\nThis is where action binding, replay protection, and expiry\nare enforced BEFORE the consequential action executes.\n\nPer Section 12: A valid VCC attached to a different action MUST fail.\nPer Section 13: Same VCC presented twice MUST fail (CONSUMED).","operationId":"vcc_verify_v1_vcc_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/{vcc_id}":{"get":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Get","description":"Retrieve a VCC by ID. Returns current consumption status.","operationId":"vcc_get_v1_vcc__vcc_id__get","parameters":[{"name":"vcc_id","in":"path","required":true,"schema":{"type":"string","title":"Vcc Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/schema/spec":{"get":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Schema","description":"VCC minimum spec and gate document summary.\nNo auth required.","operationId":"vcc_schema_v1_vcc_schema_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/gate-document":{"get":{"tags":["Engineering Baseline Gate"],"summary":"Vcb Gate Document","description":"VeriSigilAI Canonical Engineering Baseline & VCC Integration Gate v1.0\nAll 24 sections locked as constants. No auth required.","operationId":"vcb_gate_document_v1_vcb_gate_document_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vertical/payment-destination":{"post":{"tags":["Payment Destination Vertical — Proof Path v1.0"],"summary":"Vertical Payment Destination","description":"Payment Destination Change — First Real Vertical (Section 7).\n\nComplete proof chain per expert direction:\nProposal → Authority → State → Material Commitment →\nVCB Admissibility → Commit-Time Requalification → VCC →\nActuator Enforcement → Consequence Observation →\nEvidence Seal → Proof Passport → Independent Verification\n\nThis is VCB/VCC Proof Path v1.0.\nSection 24 — the ultimate test:\n- Who authorized this? VCC answers.\n- What exactly was authorized? VCC answers.\n- Was authority valid at commitment? Evidence answers.\n- Was beneficiary changed during delegation? Material commitment answers.\n- Did enforcement boundary enforce? Enforcement evidence answers.\n- Did destination change? Consequence evidence answers (or NOT_PROVABLE).\n- Verifiable without VeriSigil server? Independent verifier answers.","operationId":"vertical_payment_destination_v1_vertical_payment_destination_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/actuator/payment/verify-and-execute":{"post":{"tags":["Payment Actuator — Enforcement Boundary"],"summary":"Actuator Payment Verify Execute","description":"Payment Actuator — the REAL enforcement boundary (Section 6).\n\nThe actuator verifies the VCC independently before executing.\nIt does NOT trust the VCB API alone.\n\nRejects: no VCC, invalid, expired, consumed, wrong action,\n         wrong beneficiary, wrong amount, wrong enforcement point.\n\nSection 17: this endpoint should be tested for direct bypass\n(can the consequence be caused without passing through this path?).","operationId":"actuator_payment_verify_execute_v1_actuator_payment_verify_and_execute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/actuator/payment/log":{"get":{"tags":["Payment Actuator — Enforcement Boundary"],"summary":"Actuator Payment Log","description":"Actuator enforcement log — all accepted and rejected executions.","operationId":"actuator_payment_log_v1_actuator_payment_log_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/issue/v2":{"post":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Issue V2","description":"VCC issuance v2 — full binding per expert direction Section 5.\nAdds: material_commitment, requalification_at, policy_hash.","operationId":"vcc_issue_v2_v1_vcc_issue_v2_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/verify-offline":{"post":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Verify Offline","description":"Independent VCC verification — no VeriSigil API or database required.\nSection 13 + 19 of the expert direction.\n\nWorks with: Internet OFF, VeriSigil server OFF, VCB server OFF.\nUses only: VCC object + public key + presented action.\n\nResult: VALID | INVALID | NOT_PROVABLE\nNo auth required — this is the public verifier.","operationId":"vcc_verify_offline_v1_vcc_verify_offline_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof-passport/build":{"post":{"tags":["Proof Passport"],"summary":"Proof Passport Build","description":"Build a Proof Passport — Section 14.\nHonest about what is and is not provable.\nCONSEQUENCE_NOT_OBSERVED when effect unobservable.","operationId":"proof_passport_build_v1_proof_passport_build_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/material-commitment/build":{"post":{"tags":["Material Commitment"],"summary":"Material Commitment Build","description":"Build a material commitment with fingerprint. No auth — public primitive.","operationId":"material_commitment_build_v1_material_commitment_build_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/material-commitment/verify":{"post":{"tags":["Material Commitment"],"summary":"Material Commitment Verify","description":"Verify material commitment was preserved through delegation.\nPRESERVED | AUTHORIZED_MUTATION | COMMITMENT_MUTATION.\nNo auth — public primitive.","operationId":"material_commitment_verify_v1_material_commitment_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/run-suite":{"post":{"tags":["Adversarial Suite"],"summary":"Adversarial Run Suite","description":"Run the 17-class adversarial suite (Section 16 of expert direction).\n\nPer expert instruction:\n- Failed tests are NOT hidden\n- Results include: Attack ID, environment, version, input, expected, actual, PASS/FAIL\n- 'zero bypasses' is NOT claimed until real actuator tests pass\n- PENDING attacks require real actuator integration\n\nProvide a base_vcc and base_action for the suite to test against.","operationId":"adversarial_run_suite_v1_adversarial_run_suite_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/bypass-test":{"get":{"tags":["Adversarial Suite"],"summary":"Adversarial Bypass Test","description":"Bypass test (Section 17) — can the actuator be reached without VCB/VCC?\n\nTests: direct API, no VCC, wrong VCC, tampered VCC.\nThe actuator must reject ALL paths that bypass the enforcement boundary.\nEvery path capable of causing the consequence must pass through the VCC gate.","operationId":"adversarial_bypass_test_v1_adversarial_bypass_test_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/gates":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Gates","description":"Execute all 8 engineering gates (0-7) per Section 21.\nAny critical FAIL = no production designation.\nGate results are executable, not text descriptions.\nNo auth required — transparency is part of the architecture.","operationId":"engineering_gates_v1_engineering_gates_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/material-commitment/canonicalization-test":{"post":{"tags":["Material Commitment"],"summary":"Material Commitment Canonicalization Test","description":"Run all canonicalization attack vectors (expert concern Section 6).\n\nTests that the canonical form defeats:\n- float representation (10000 vs 10000.00 vs 1e4)\n- case sensitivity (A vs a vs A)\n- whitespace (A vs ' A ')\n- null/missing equivalence\n- amount escalation detection\n\nNo auth required — public test surface.","operationId":"material_commitment_canonicalization_test_v1_material_commitment_canonicalization_test_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/atomicity-spec":{"get":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Atomicity Spec","description":"VCC atomicity specification and production blocker documentation.\nthreading.Lock is not sufficient for multi-instance deployment.\nNo auth required.","operationId":"vcc_atomicity_spec_v1_vcc_atomicity_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/actuator/integration-spec":{"get":{"tags":["Payment Actuator — Enforcement Boundary"],"summary":"Actuator Integration Spec","description":"Real actuator integration path — kernel-level enforcement + Alkama CLARA Run 4.\nA13-A17 pending status is TEMPORARY not permanent.\nNo auth required.","operationId":"actuator_integration_spec_v1_actuator_integration_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcc/independent-reproduction-spec":{"get":{"tags":["VCC — Verifiable Consequence Certificate"],"summary":"Vcc Independent Reproduction Spec","description":"Independent reproduction specification (Gate 7).\n\nHonest distinction: self-contained ≠ independently reproduced.\nWhat an external auditor needs to verify without VeriSigil.\nNo auth required.","operationId":"vcc_independent_reproduction_spec_v1_vcc_independent_reproduction_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof-run/1/spec":{"get":{"tags":["Proof Run 1"],"summary":"Proof Run 1 Spec","description":"PROOF_RUN_1 specification — next milestone is execution, not code.\n\nExpert: \"One real successful proof run is worth more than\n         another 50,000 lines of code.\"\n\n14-step complete proof transaction sequence.\nNo auth required.","operationId":"proof_run_1_spec_v1_proof_run_1_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof-run/1/execute":{"post":{"tags":["Proof Run 1"],"summary":"Proof Run 1 Execute","description":"Execute PROOF_RUN_1 — all 14 steps against the reference implementation.\n\nGate 3 (real actuator) required for step 7-9.\nCurrent: reference actuator for steps 7-9.\nResult: test evidence, not claims.","operationId":"proof_run_1_execute_v1_proof_run_1_execute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/proof-run/1/history":{"get":{"tags":["Proof Run 1"],"summary":"Proof Run 1 History","description":"History of PROOF_RUN_1 executions.","operationId":"proof_run_1_history_v1_proof_run_1_history_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/evaluate":{"post":{"tags":["VCB — Canonical API"],"summary":"Vcb Evaluate Canonical","description":"POST /v1/vcb/evaluate — canonical VCB evaluation endpoint (Section 44).\nUses VCBFinalEngine (Section 54) with 23-step adjudication (Section 55).\nAll evaluation dimensions (novelty, predictability, reversibility,\ncounterfactual, coherence, consequence envelope) are VCB-internal.\nNOT new engines — structured evidence feeding VCB.","operationId":"vcb_evaluate_canonical_v1_vcb_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/declaration/open":{"post":{"tags":["Declaration Obligation"],"summary":"Open Declaration Obligation","description":"Open a Declaration Obligation when a materiality threshold is crossed.\n\nExpert direction: VCB does not claim it can force accountability.\nIt proves when accountability was required, who was responsible,\nwhat deadline existed, and whether a response occurred.\n\nThis is the DECLARATION OBLIGATION mechanism.\nIf no valid declaration is received before deadline: DECLARATION_SILENT.\nDECLARATION_SILENT is a positively evidenced event, not an absence.","operationId":"open_declaration_obligation_v1_declaration_open_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeclarationObligationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/declaration/{obligation_id}/respond":{"post":{"tags":["Declaration Obligation"],"summary":"Respond To Declaration","description":"Record a declaration response — RELIANCE_REAFFIRMED or NON_RELIANCE_DECLARED.\nThe response itself is cryptographically signed and timestamped.","operationId":"respond_to_declaration_v1_declaration__obligation_id__respond_post","parameters":[{"name":"obligation_id","in":"path","required":true,"schema":{"type":"string","title":"Obligation Id"}},{"name":"disposition","in":"query","required":false,"schema":{"type":"string","default":"RELIANCE_REAFFIRMED","title":"Disposition"}},{"name":"basis","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis"}},{"name":"responder_identity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Responder Identity"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/declaration/{obligation_id}/status":{"get":{"tags":["Declaration Obligation"],"summary":"Get Declaration Status","description":"Check obligation status. If deadline passed without response: records DECLARATION_SILENT.\nDECLARATION_SILENT is not a system failure — it is positively evidenced accountability absence.\nThis is VCB's 'Evidenced Silence' mechanism.","operationId":"get_declaration_status_v1_declaration__obligation_id__status_get","parameters":[{"name":"obligation_id","in":"path","required":true,"schema":{"type":"string","title":"Obligation Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/seal":{"post":{"tags":["VCB — Canonical API"],"summary":"Vcb Seal","description":"POST /v1/vcb/seal — issue SigilMark after VCB ALLOW decision.\nSection 20: SigilMark is the portable machine-readable governance proof.","operationId":"vcb_seal_v1_vcb_seal_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/passport":{"post":{"tags":["VCB — Canonical API"],"summary":"Vcb Passport","description":"POST /v1/vcb/passport — build Proof Passport (Section 30).\nAssembles complete evidence package. Honest about what is NOT proven.","operationId":"vcb_passport_v1_vcb_passport_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/audit":{"post":{"tags":["VCB — Canonical API"],"summary":"Vcb Audit","description":"POST /v1/vcb/audit — build offline proof package (Section 66).\nComplete package verifiable without VeriSigil server.","operationId":"vcb_audit_v1_vcb_audit_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/webhook":{"post":{"tags":["VCB — Canonical API"],"summary":"Vcb Webhook","description":"POST /v1/vcb/webhook — receive consequence observations and enforcement events.\nNo auth — intended for actuator callback. Validates signature.","operationId":"vcb_webhook_v1_vcb_webhook_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/consequence/schema":{"get":{"tags":["VCB — Canonical API"],"summary":"Vcb Consequence Schema","description":"Consequence types, bounds, envelope, and uncertainty governance. No auth.","operationId":"vcb_consequence_schema_v1_vcb_consequence_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/transition/bind":{"post":{"tags":["VCB — Canonical API"],"summary":"Vcb Transition Bind","description":"POST /v1/vcb/transition/bind — create TransitionIntegrityRecord (Section 6).\nValidity does not automatically survive movement.","operationId":"vcb_transition_bind_v1_vcb_transition_bind_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/sigilmark/verify":{"post":{"tags":["VCB — Canonical API"],"summary":"Vcb Sigilmark Verify","description":"Verify SigilMark offline — returns VALID | INVALID | NOT_PROVABLE.\nNo auth required — public verifier.","operationId":"vcb_sigilmark_verify_v1_vcb_sigilmark_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/alternate-allow-paths":{"get":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Alternate Allow Paths","description":"Gate 1: Scan for alternate ALLOW paths that bypass VCBFinalEngine.","operationId":"adversarial_alternate_allow_paths_v1_adversarial_alternate_allow_paths_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/sigilmark-mutations":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Sigilmark Mutations","description":"Gate 2: 15 SigilMark mutation attacks.\nEvery mutation must produce INVALID and must not reach the actuator.\nProves SigilMark is action-bound governance proof, not a permission slip.","operationId":"adversarial_sigilmark_mutations_v1_adversarial_sigilmark_mutations_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/transition-attacks":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Transition Attacks","description":"Gate 3: Attack TransitionIntegrityRecord.\nProves \"Validity does not automatically survive movement.\"","operationId":"adversarial_transition_attacks_v1_adversarial_transition_attacks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/envelope-attacks":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Envelope Attacks","description":"Gate 4: Attack the Consequence Envelope.\nProves: valid decision + action outside envelope = BLOCK.\n\"A valid governance decision does not authorize consequences outside the committed envelope.\"","operationId":"adversarial_envelope_attacks_v1_adversarial_envelope_attacks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/uncertainty-attacks":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Uncertainty Attacks","description":"Gate 5: UNKNOWN uncertainty must NEVER silently become ALLOW.\nExpert: \"This is probably the most important conceptual test.\"","operationId":"adversarial_uncertainty_attacks_v1_adversarial_uncertainty_attacks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/actuator-paths":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Actuator Paths","description":"Gate 6: Five actuator paths per expert recommendation.\nPath A: ALLOW → actuator → consequence.\nPath B: BLOCK → actuator → impossible.\nPath C: ALLOW → SigilMark removed → BLOCK.\nPath D: ALLOW → alternative API → BLOCK / NOT_PROVABLE.\nPath E: direct datastore mutation → DETECTED / NOT_PROVABLE.","operationId":"adversarial_actuator_paths_v1_adversarial_actuator_paths_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/concurrency-test":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Concurrency Test","description":"Gate 7: Multi-instance and concurrency attack.\n100 concurrent requests → exactly 1 VALID consumption.\nExpert: \"This is a production blocker, not an optimization.\"","operationId":"adversarial_concurrency_test_v1_adversarial_concurrency_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/evidence-integrity":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Evidence Integrity","description":"Evidence integrity attacks — every tampered link must invalidate the passport.\nExpert: \"Mutate every link. decision.json modified → invalidate downstream.\"","operationId":"adversarial_evidence_integrity_v1_adversarial_evidence_integrity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/run-all-gates":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Run All Gates","description":"Run all 8 proof gates in sequence and return consolidated result.\nArchitecture frozen. This is PROOF not new architecture.","operationId":"adversarial_run_all_gates_v1_adversarial_run_all_gates_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/gate-history":{"get":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Gate History","description":"All gate test results. Evidence record — not claims.","operationId":"adversarial_gate_history_v1_adversarial_gate_history_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/tcb":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Tcb","description":"VCB Trusted Computing Base measurement.\nExpert: identify the smallest code that determines ALLOW/DENY/SigilMark.\nNo auth required.","operationId":"engineering_tcb_v1_engineering_tcb_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/allow-path-coverage":{"get":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Allow Path Coverage","description":"Enhanced Gate 1: ALLOW-path coverage analysis.\nExpert: enumerate ALL paths that could cause a consequence.\nClassify each: COVERED/BLOCKED/MONITORED/NOT_PROVABLE/NOT_TESTABLE.","operationId":"adversarial_allow_path_coverage_v1_adversarial_allow_path_coverage_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/toctou":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Toctou","description":"TOCTOU (Time-of-Check to Time-of-Use) test suite.\nExpert: attack commit-time requalification specifically.\nT0→T7 timeline — change conditions between evaluation and commit.\n\nExpected: STALE / REQUALIFICATION_REQUIRED / INVALID\nNever: old ALLOW → automatic execution","operationId":"adversarial_toctou_v1_adversarial_toctou_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/actuator/payment/ledger-verify":{"post":{"tags":["Payment Actuator — Enforcement Boundary"],"summary":"Actuator Payment Ledger Verify","description":"Payment ledger simulator — independently verifies SigilMark before committing.\nExpert: narrow, controlled simulator. Actuator does NOT trust VCB's prior ALLOW.\nVerifies all 18 required fields. One successful commitment per SigilMark.","operationId":"actuator_payment_ledger_verify_v1_actuator_payment_ledger_verify_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/actuator/payment/ledger":{"get":{"tags":["Payment Actuator — Enforcement Boundary"],"summary":"Actuator Payment Ledger","description":"Simulated payment ledger — all committed transactions.","operationId":"actuator_payment_ledger_v1_actuator_payment_ledger_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/enhanced-claim-matrix":{"get":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Enhanced Claim Matrix","description":"Enhanced Claim → Evidence → Reproduction matrix.\nExpert: single source of truth for what VeriSigilAI is allowed to claim publicly.\nNo auth required.","operationId":"adversarial_enhanced_claim_matrix_v1_adversarial_enhanced_claim_matrix_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/run-final-demo":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Run Final Demo","description":"Run the final proof demonstration — 9 attack scenarios.\nExpert Section 12: one clean demonstration that can be recorded and independently repeated.","operationId":"adversarial_run_final_demo_v1_adversarial_run_final_demo_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/distributed-atomicity":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Distributed Atomicity","description":"P0-05 / V-002 — Distributed Atomicity Test.\n\nProves the exactly-one-consequence invariant:\n  N concurrent requests against the same VCC → exactly 1 durable consumption.\n\nSingle-instance: uses Supabase atomic UPDATE (consume_sigilmark function).\nMulti-instance: requires 2+ Railway replicas (V-002 full proof).\n\nEvidence fields: test_id, build_hash, database_target, n_threads,\n  vcc_id, consumption_results, durable_count, invariant_holds, verdict.","operationId":"adversarial_distributed_atomicity_v1_adversarial_distributed_atomicity_post","parameters":[{"name":"n_threads","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"N Threads"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/toctou-zero-consequence":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Toctou Zero Consequence","description":"Section 4: TOCTOU zero-consequence proof.\nExpert: \"The proof needs to demonstrate: invalid governance state → blocked commit → ZERO committed consequence.\"\nNot merely \"INVALID HASH\" — proves the ledger received ZERO commits.","operationId":"adversarial_toctou_zero_consequence_v1_adversarial_toctou_zero_consequence_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/not-provable-attacks":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Not Provable Attacks","description":"Section 6: NOT_PROVABLE must never be coercible into ALLOW.\nAttack from: API param manipulation, null values, malformed evidence,\nadmin override, fallback logic, serialization edge cases.\nExpert: \"NOT_PROVABLE must never be coercible into ALLOW by configuration,\nfallback, exception handling, administrator override, or default value.\"","operationId":"adversarial_not_provable_attacks_v1_adversarial_not_provable_attacks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/passport-mutations":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Passport Mutations","description":"Section 9: Attack the Proof Passport itself — mutate every link.\nExpert: \"Can any mutated package still produce VALID? Expected: No.\"\nCritical invariant: Authorization evidence cannot substitute for consequence evidence.","operationId":"adversarial_passport_mutations_v1_adversarial_passport_mutations_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/negative-properties":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Negative Properties","description":"Section 10: Universal negative properties.\nExpert: test properties, not just individual test cases.\nPROP_1 through PROP_8 — each proves a universal invariant.","operationId":"adversarial_negative_properties_v1_adversarial_negative_properties_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/fault-injection":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Fault Injection","description":"Section 11: Fault injection — failure must never silently become ALLOW or OBSERVED.\nExpert: \"VCB ALLOW → actuator timeout → What happened?\nMust say ENFORCEMENT_UNKNOWN, CONSEQUENCE = NOT_PROVABLE, RECONCILIATION_REQUIRED.\"","operationId":"adversarial_fault_injection_v1_adversarial_fault_injection_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/external-challenge-package":{"get":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial External Challenge Package","description":"Section 12/14: External adversarial challenge package.\nGive an independent reviewer everything needed to reproduce and attack.\nExpert: \"Do not tell them the vulnerabilities you expect them to find. Let them attack it.\"","operationId":"adversarial_external_challenge_package_v1_adversarial_external_challenge_package_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/proof-roadmap":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Proof Roadmap","description":"VCB Proof & Reproducibility Release — full phase roadmap.\nExpert: FREEZE → ATTACK → DISTRIBUTE → REPRODUCE → EXTERNALLY CHALLENGE\nNo auth required.","operationId":"engineering_proof_roadmap_v1_engineering_proof_roadmap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/csega/evaluate":{"post":{"tags":["CSEGA — Consequence-Scoped Evidence Governance Adjudication"],"summary":"Vcb Csega Evaluate","description":"CSEGA engine — 20-step consequence-scoped adjudication.\nOutput: VERIFIED | FAILED | NOT_PROVABLE.\nVCB's job: prove what governance can actually establish.\nNever infer what the evidence does not support.","operationId":"vcb_csega_evaluate_v1_vcb_csega_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/gcp/build":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Gcp Build","description":"Build a Governance Closure Proof (GCP) — primary VCB proof artifact.\nContains identity_manifest, authority_manifest, responsibility_manifest,\nCSEGA_result, verification_instructions.\nIndependently verifiable without VeriSigil server.","operationId":"vcb_gcp_build_v1_vcb_gcp_build_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/action-binding/create":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Action Binding Create","description":"Create an ActionBinding — mandatory for exact action binding.\nHuman approval does not automatically authorize a later modified action.","operationId":"vcb_action_binding_create_v1_vcb_action_binding_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/responsibility/create":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Responsibility Create","description":"Create a ResponsibilityObject — NEW VCB CORE PRIMITIVE.\nCAPABILITY != AUTHORITY != RESPONSIBILITY.\nDELEGATION != AUTHORITY INFLATION.","operationId":"vcb_responsibility_create_v1_vcb_responsibility_create_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/intervention/record":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Intervention Record","description":"Record an intervention and assess its effectiveness.\nCONTROL_EXISTS != CONTROL_EFFECTIVE.\nMust climb: DECLARED→DEPLOYED→REACHABLE→INVOKABLE→EXECUTED→TIMELY→EFFECTIVE→PROVABLE.","operationId":"vcb_intervention_record_v1_vcb_intervention_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/consequence/assess":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Consequence Assess","description":"Compare AUTHORIZED vs ACTUAL consequence.\nALLOW != EXECUTED. EXECUTED != CONSEQUENCE MATCHED.","operationId":"vcb_consequence_assess_v1_vcb_consequence_assess_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/csega-tests":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Csega Tests","description":"Run the 15 adversarial tests from Section 40 of VCB Engineering Architecture v1.1.\nTests control existence, reachability, effectiveness, and provability.\nIncludes: late stop, ineffective rollback, conflicting evidence, enforcement bypass,\ncontrol acts too late, counterfactual uncertain.","operationId":"adversarial_csega_tests_v1_adversarial_csega_tests_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/architecture-v11":{"get":{"tags":["VCB — Canonical API"],"summary":"Vcb Architecture V11","description":"VCB Engineering Architecture v1.1 — canonical reference.\nCONSEQUENCE-BOUND GOVERNANCE PROOF INFRASTRUCTURE.\nCSEGA engine. GCP proof artifact. All frozen invariants.\nNo auth required.","operationId":"vcb_architecture_v11_v1_vcb_architecture_v11_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/governability-demo":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Governability Demo","description":"Section 15: ₦500,000 refund adversarial scenario.\nExpert: \"AI agent authorized to issue a ₦500,000 refund.\"\n\"VCB must detect: definition changed, authority revoked, action mutated.\"\n\"If consequence occurs despite control: ENFORCEMENT_BYPASS.\"\n\"If VCB cannot establish whether consequence would have occurred: NOT_PROVABLE.\"\nThe system must never manufacture certainty.","operationId":"adversarial_governability_demo_v1_adversarial_governability_demo_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/admissibility-receipt/issue":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Ar Issue","description":"Issue an Admissibility Receipt (AR) — generated BEFORE consequence-bearing commitment.\nNot an audit log — precedes consequence and determines governance.","operationId":"vcb_ar_issue_v1_vcb_admissibility_receipt_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/continuity-proof/build":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Continuity Proof Build","description":"Build a ContinuityProof — the STILL? question.\nExplicitly identifies what changed. Stronger than 'revalidated'.\nResult: STILL_VALID | NO_LONGER_VALID | NOT_PROVABLE","operationId":"vcb_continuity_proof_build_v1_vcb_continuity_proof_build_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/control-effectiveness/assess":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Cee Assess","description":"ControlEffectivenessEvidence — CONTROL_FIRED != CONTROL_EFFECTIVE.\nFive explicit states. Must not be collapsed.","operationId":"vcb_cee_assess_v1_vcb_control_effectiveness_assess_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/consequence-boundary/attest":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Cba Attest","description":"ConsequenceBoundaryAttestation — establishes the actual boundary where\naction became consequential: QUEUED | TRANSMITTED | ACCEPTED | COMMITTED | SETTLED.","operationId":"vcb_cba_attest_v1_vcb_consequence_boundary_attest_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/definition/bind":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Definition Bind","description":"Bind a decision to the definition under which it was evaluated.\nEnables: EVALUATED_UNDER_CURRENT_DEFINITION vs EVALUATED_UNDER_SUPERSEDED_DEFINITION.","operationId":"vcb_definition_bind_v1_vcb_definition_bind_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/csega/v2/evaluate":{"post":{"tags":["CSEGA — Consequence-Scoped Evidence Governance Adjudication"],"summary":"Vcb Csega V2 Evaluate","description":"CSEGA v2 — Two separate questions, never collapsed into one score.\nQuestion A: Admissibility\nQuestion B: Governability\nNo governance score — structured findings.","operationId":"vcb_csega_v2_evaluate_v1_vcb_csega_v2_evaluate_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/gcp/v2/build":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Gcp V2 Build","description":"GCP v2 — Four proof families. CSEGA v2 adjudication.\nIndependently verifiable without VeriSigil server.","operationId":"vcb_gcp_v2_build_v1_vcb_gcp_v2_build_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/audit-report":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Audit Report","description":"Three-Day Architecture Integrity & Engineering Audit Report.\nExecutable behavioral tests — not just code inspection.\nNo claim of implementation integrity without reproducible evidence.\nNo auth required.","operationId":"engineering_audit_report_v1_engineering_audit_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/restart-replay":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Restart Replay","description":"P0-04/P0-07 — Restart Replay Test (V-001 live proof).\nExpert requirement: all 12 evidence fields must be present in response.\n\nSequence:\n  1. Issue VCC (SigilMark)\n  2. Verify/consume it (first use — should PASS)\n  3. Simulate restart — clear in-memory state\n  4. Replay same VCC (should FAIL if DB is authoritative)\n\nIf Supabase is configured: consumed state persists → replay FAILS → PASS\nIf Supabase not available: replay SUCCEEDS → V-001-UNRESOLVED\n\nEvidence fields per expert requirement:\n  test_id, build_hash, database_target, initial_state, consume_result,\n  persistence_result, restart_event, post_restart_state, replay_result,\n  expected_result, actual_result, environment, timestamp","operationId":"adversarial_restart_replay_v1_adversarial_restart_replay_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/distributed-replay":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Distributed Replay","description":"Test B + C: Distributed replay and crash boundary tests.\nReturns current spec and status.\nFull execution requires Supabase + multiple Railway instances.","operationId":"adversarial_distributed_replay_v1_adversarial_distributed_replay_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/supabase-ddl":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Supabase Ddl","description":"Supabase DDL for V-001/V-002 production persistence fix.\nRun this SQL in Supabase before multi-instance deployment.\nNo auth required.","operationId":"engineering_supabase_ddl_v1_engineering_supabase_ddl_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/definition/history":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Definition History","description":"Record definition version to immutable history.\nHistorical truth preservation — V2 does not retroactively invalidate V1 decisions.","operationId":"vcb_definition_history_v1_vcb_definition_history_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/definition/historical-validity":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Historical Validity","description":"Check historical validity of evidence E1 against a newer definition.\nE1 evaluated under V1 is VALID_UNDER_V1 even when V2 is current.\nNo auth — public verification primitive.","operationId":"vcb_historical_validity_v1_vcb_definition_historical_validity_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Req"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/timing-attacks":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Timing Attacks","description":"Timing variation adversarial tests.\nExpert: \"Vary the timing. The system must produce position-specific evidence,\nnot collapse to a generic DENIED.\"\n\nTests control position at T-3, T-1, T+0, T+1 (replay), T+2 (mutation).\nEach produces distinct position evidence, not one DENIED.","operationId":"adversarial_timing_attacks_v1_adversarial_timing_attacks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/production-acceptance-spec":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Production Acceptance Spec","description":"Production acceptance test specification.\nExpert-mandated: ALL must pass before production designation.\nNo auth required.","operationId":"engineering_production_acceptance_spec_v1_engineering_production_acceptance_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/control-position/assess":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Control Position Assess","description":"Assess control's position relative to consequence.\nFour positions: BEFORE / DURING / AFTER / UNAVOIDABLE.\nNot collapsed to generic DENIED — position-specific evidence.","operationId":"vcb_control_position_assess_v1_vcb_control_position_assess_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/model-compromise":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Model Compromise","description":"Data poisoning / model compromise adversarial tests (Sections 10-13).\nVCB must evaluate proposals independently of whether the originating model is trusted.\nA poisoned, backdoored, or compromised model must not self-authorise.\nCorrect claim: independent examination boundary, not backdoor elimination.","operationId":"adversarial_model_compromise_v1_adversarial_model_compromise_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/privileged-user-attacks":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Privileged User Attacks","description":"Section 22: Privileged-user attack tests.\nWhat happens if someone with DB/system access becomes malicious?\nExpected: authorization failure, immutable evidence, detectable integrity change,\nno silent historical rewrite.","operationId":"adversarial_privileged_user_attacks_v1_adversarial_privileged_user_attacks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/timing-extended":{"post":{"tags":["Adversarial Proof Gates"],"summary":"Adversarial Timing Extended","description":"Extended timing attacks (Section 16 expert direction).\nTests authority revocation and definition/evidence changes at every timing point.\nThe system must understand TIME, not merely state.","operationId":"adversarial_timing_extended_v1_adversarial_timing_extended_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/master-status":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Master Status","description":"VCB Master Status — consolidated from all 3 expert documents.\nArchitecture frozen. Proof pending. NOT production ready.\nThe evidence ladder shows exactly where each component sits.\nNo auth required.","operationId":"engineering_master_status_v1_engineering_master_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/proof-ladder":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Proof Ladder","description":"Master proof ladder L0-L7.\nEvery public claim must carry its evidence level.\nHigher claim = higher evidence level required.\nNo auth required.","operationId":"engineering_proof_ladder_v1_engineering_proof_ladder_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/supply-chain-spec":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Supply Chain Spec","description":"Supply chain security specification (Section 21).\nProtect the VCB/evidence infrastructure itself.\nNo auth required.","operationId":"engineering_supply_chain_spec_v1_engineering_supply_chain_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/authority-continuity/record":{"post":{"tags":["GCP — Governance Closure Proof"],"summary":"Vcb Authority Continuity Record","description":"Authority Continuity / ACS record (Section 9).\nacs_version, acs_hash, condition_binding_status, authority_continuity_status.\nNOT a new architecture layer — integrity metadata in existing chain.","operationId":"vcb_authority_continuity_record_v1_vcb_authority_continuity_record_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/market-research":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Market Research","description":"VCB market research — fact-checked 2026.\nGrant Thornton AI Proof Gap, CISO AI Risk Report, DEMM-Bench,\nEU AI Act enforcement, SR 26-2 banking, Singapore IMDA,\ncompetitor awareness, real incident registry.\nNo auth required.","operationId":"engineering_market_research_v1_engineering_market_research_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/proof-semantics":{"get":{"tags":["VCB — Canonical API"],"summary":"Vcb Proof Semantics","description":"VCB proof semantics — what each state means, what it does NOT mean.\nPublic reference. No auth required.","operationId":"vcb_proof_semantics_v1_vcb_proof_semantics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/baseline-gate":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Baseline Gate","description":"Engineering baseline gate — the single honest status page.\nReturns: architecture status, proof ladder positions, production gate status,\nthree demo artifacts, public messaging locked strings.\nThis is what to show a technically capable reviewer before any partnership or pilot.\nNo auth required.","operationId":"engineering_baseline_gate_v1_engineering_baseline_gate_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/maturity-map":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Maturity Map","description":"VCB capability maturity map — honest proof states for every component.\nThe hard correction: '37/37 checks pass' = specs present, NOT V-001/V-002 proven.\nShows exact proof state A-G for each capability.\nNo auth required.","operationId":"engineering_maturity_map_v1_engineering_maturity_map_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/behavioral-preflight":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Behavioral Preflight","description":"Quick behavioral preflight — answers four questions about the current codebase.\nReports honest proof states. No overclaiming.\nNo auth required.","operationId":"engineering_behavioral_preflight_v1_engineering_behavioral_preflight_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/build-snapshot":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Build Snapshot","description":"AUTHORITATIVE BUILD SNAPSHOT — single source of truth.\nExpert requirement: \"The repository should be the source of truth.\nNobody should manually quote different numbers from different reports.\"\n\nExplains the route count discrepancy (1246 decorators vs 1251 FastAPI routes).\nDocuments all 23 duplicate functions honestly.\nSeparates tests_implemented from tests_executed.\nShows exact capability maturity states.\nNo auth required.","operationId":"engineering_build_snapshot_v1_engineering_build_snapshot_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/production-gate-v2":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Production Gate V2","description":"Production gate v2 — complete honest status with new market data.\nIncludes Pathlock 2026, signing key documentation, Microsoft competitor.\nNo auth required.","operationId":"engineering_production_gate_v2_v1_engineering_production_gate_v2_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/master-direction":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Master Direction","description":"VCB Master Engineering Direction — frozen post-expert consolidation.\nAccountability Resilience as design objective.\nFive audit domains. Ten frozen engineering rules.\nEvidence type distinction. P0/P1/P2 sequence.\nNo auth required.","operationId":"engineering_master_direction_v1_engineering_master_direction_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/red-team-report":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Red Team Report","description":"VCB Pre-Public Red Team Report.\nAll 12 P0 blockers with current status.\n16 attack scenarios with expected vs actual results.\nPublic Claim Register — approved and blocked claims.\nDO NOT SAY register.\nNo auth required — transparency is part of the philosophy.","operationId":"engineering_red_team_report_v1_engineering_red_team_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/claim-register":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Claim Register","description":"Machine-readable Public Claim Register.\nEvery row is either APPROVED or BLOCKED with evidence state and reason.\nNo social-media statement should exist without an approved row here.\nNo auth required.","operationId":"engineering_claim_register_v1_engineering_claim_register_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/p0-02a-consistency":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering P0 02A Consistency","description":"P0-02A — Build Truth Consistency Check.\nExpert: \"Create one automated test that queries all four truth endpoints\nand proves they agree on build identity, V-001/V-002 maturity, live test count,\nproduction readiness, route count, and architecture status.\"\n\nThis endpoint SELF-CHECKS that all truth endpoints would return consistent values.\nIt does NOT make HTTP calls — it computes from the same in-process module\nto confirm the values are consistent at the source.\n\nIf this returns CONSISTENT: the four truth endpoints will agree.\nIf INCONSISTENT: there is a code-level disagreement — P0-02 blocker.\nNo auth required.","operationId":"engineering_p0_02a_consistency_v1_engineering_p0_02a_consistency_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/p0-02b-deployment-identity":{"post":{"tags":["Engineering Gates 0-7"],"summary":"Engineering P0 02B Deployment Identity","description":"P0-02B — Deployment Identity Verification (renamed per expert correction).\nExpert: \"Don't let the word 'independent' become broader than what the test establishes.\"\n\nWhat this proves:\n  SHA(local file) = SHA reported by deployed build-snapshot endpoint.\n\nWhat this does NOT prove:\n  - That Railway's self-reported SHA is truthful (circular risk noted)\n  - That the deployed system behaves correctly\n  - That evidence is independently reproducible\n\nCircularity risk (expert identified):\n  Asking Railway \"what is your SHA?\" and trusting the answer is partially circular.\n  A compromised deployment could report a false SHA.\n  The stronger version downloads the deployed main.py and hashes it independently.\n  This endpoint does BOTH: checks self-reported SHA AND attempts independent hashing.\n\nFour-equality chain (what must match):\n  LOCAL FILE SHA = DEPLOYED FILE SHA = BUILD-SNAPSHOT SHA = TRUTH-ENDPOINT SHA\n\nNo auth required for the check.","operationId":"engineering_p0_02b_deployment_identity_v1_engineering_p0_02b_deployment_identity_post","parameters":[{"name":"railway_base_url","in":"query","required":false,"schema":{"type":"string","default":"https://verisigil-api-production.up.railway.app","title":"Railway Base Url"}},{"name":"x-api-key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/p0-02c-contradiction-test":{"post":{"tags":["Engineering Gates 0-7"],"summary":"Engineering P0 02C Contradiction Test","description":"P0-02C — Controlled Contradiction Test.\nExpert: \"A red-team system isn't proven because it returns TRUE.\nIt is proven when we can deliberately make it return FALSE for a controlled contradiction.\"\n\nThis endpoint deliberately creates a fake inconsistent state and\nverifies that P0-02A correctly detects it as INCONSISTENT.\n\nExpected: INCONSISTENT detected = P0-02A is working correctly.\nIf INCONSISTENT is NOT detected: P0-02A has a blind spot.\nNo auth required.","operationId":"engineering_p0_02c_contradiction_test_v1_engineering_p0_02c_contradiction_test_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/build-baseline":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Build Baseline","description":"Immutable build baseline record.\nExpert: \"We need to establish a new immutable baseline.\nProve LOCAL COMMIT SHA = DEPLOYED BUILD ID = BUILD-SNAPSHOT SHA = TRUTH-ENDPOINT BUILD ID.\"\n\nThis endpoint records the current build identity as a baseline.\nEvery future check compares against this record.\nNo auth required.","operationId":"engineering_build_baseline_v1_engineering_build_baseline_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/structural-refusal-spec":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Structural Refusal Spec","description":"Structural Refusal Specification — the terrain built from merging:\n1. External governance expert's Governance Theatre Series Part 6 (structural impossibility)\n2. Cross-system capability insight (P2)\n3. Expert direction: turn structural refusal into a proof dimension of existing VCB architecture\n\nShows: frozen doctrine, COULD question expanded, condition removal matrix,\nP0-11 A-E, P0-13, STRUCTURAL_REFUSAL_PROOF schema.\nNo auth required.","operationId":"engineering_structural_refusal_spec_v1_engineering_structural_refusal_spec_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/adversarial/still-authority":{"post":{"tags":["P3 — STILL Adversarial Tests"],"summary":"Adversarial Still Authority","description":"P3 STILL adversarial test suite — 8 attacks from VCB_P3_ATTACK_SUITE.\nTests that STILL=NOT_PROVABLE and STILL=FAILED both refuse release.\nExpert direction: claim cannot advance because code exists.\nP3 graduates only when ALL attacks pass on production.","operationId":"adversarial_still_authority_v1_adversarial_still_authority_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/locked-tests/material-mutation":{"post":{"tags":["Rule 0 — Locked Tests"],"summary":"Locked Test Material Mutation","description":"Rule 0 Locked Test 1: Material mutation produces BLOCKED/BYPASSED/NOT_IMPLEMENTED.\nDocument v2.2 §0: nothing below starts until this exists against main.py.\nMust run against the real implementation, not a local test environment.\nResult must be: BLOCKED (mutation detected) or BYPASSED (failure — mutation reached actuator).","operationId":"locked_test_material_mutation_v1_locked_tests_material_mutation_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/locked-tests/authority-revocation":{"post":{"tags":["Rule 0 — Locked Tests"],"summary":"Locked Test Authority Revocation","description":"Rule 0 Locked Test 2: Authority revocation between T0 and T1 produces BLOCKED.\nDocument v2.2 §0: revocation landing between examination and commitment must\nproduce a real BLOCKED — not SPEC_ONLY, not a future plan.\nThis is the test that determines whether STILL is implemented or theoretical.","operationId":"locked_test_authority_revocation_v1_locked_tests_authority_revocation_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/p4/cedar-properties":{"post":{"tags":["P4 — Cedar Properties + DRT"],"summary":"Test Cedar Properties","description":"P4: Cedar's seven authorization properties as actual passing tests.\nDocument v2.2 §5.4: \"adopt Cedar's property list verbatim as evaluator acceptance criteria\"\nEach property has a falsifying test. All seven must pass.","operationId":"test_cedar_properties_v1_p4_cedar_properties_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/p4/drt-harness":{"post":{"tags":["P4 — Cedar Properties + DRT"],"summary":"P4 Drt Harness","description":"P4: Differential Random Testing (DRT) harness.\nDocument v2.2 §5.4: \"DRT involves generating millions of inputs—consisting of\npolicies, data, and requests—and testing that the model and production code agree.\"\n\nReference model: pure Python implementation of evaluate_release() semantics.\nProduction code: the actual evaluate_release() function.\nTest: both must agree on all generated inputs.","operationId":"p4_drt_harness_v1_p4_drt_harness_post","parameters":[{"name":"iterations","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Iterations"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/p4/vcb-invariant":{"post":{"tags":["P4 — Cedar Properties + DRT"],"summary":"Test Vcb Invariant","description":"P4: The VCB invariant — \"An inadmissible action cannot reach a protected consequence.\"\n\nTest: attempt payment with inadmissible passport → BLOCKED by actuator.\nTest: attempt payment with admissible passport → EXECUTED by actuator.\nTest: actuator.vcb_invariant_holds is True after all attempts.\n\nThis is the proof the document requires: live, adversarially tested evidence\nthat an inadmissible action cannot reach a protected consequence.","operationId":"test_vcb_invariant_v1_p4_vcb_invariant_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/p5/seal":{"post":{"tags":["P5 — COULD Causal Model"],"summary":"P5 Seal","description":"P5: VCB seal with COULD conjunct — Halpern-Pearl causal model, payment domain.\nDocument v2.2 §5.5: COULD moves from NOT_MODELLED to measured — one domain.\nIssues a passport with COULD.result = ACTUAL_CAUSE when evaluate_release + actuator confirm it.\njar_verify check_could returns COULD_VERIFIED (not UNDETERMINED.COULD_NOT_MODELLED).","operationId":"p5_seal_v1_p5_seal_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"type":"string","title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/still/check":{"post":{"tags":["STILL — Authority Continuity"],"summary":"Still Check","description":"STILL conjunct — authority continuity check.\nAnswers: does the authority that was declared at T0 still hold at T1?\n\nThis is the STILL gate. VCB uses this to determine whether:\n- The authority_hash declared at seal time is still valid\n- No revocation has occurred between T0 (issue) and T1 (now)\n- The authority chain has not collapsed\n\nP5/STILL: this endpoint enforces the STILL conjunct.\nWhen a passport is presented for verification at T1, call this endpoint\nto determine whether the authority declared at T0 still holds.\n\nReturns:\n  PROVABLE  — authority confirmed current, no collapse detected\n  FAILED    — authority revoked or collapsed since T0\n  NOT_VERIFIED — cannot determine (no authority record found)","operationId":"still_check_v1_still_check_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/what/record":{"post":{"tags":["WHAT — Outcome Correlation"],"summary":"What Record","description":"WHAT conjunct — outcome correlation.\nRecords operational evidence that a consequence occurred and ties it\nback to the exact passport that authorised it.\n\nThis is the final conjunct. After a consequence executes:\n- Record the outcome (executed, amount, vendor, timestamp)\n- Hash the outcome and tie it to the passport sigilmark_id\n- The WHAT field in the passport can then be independently verified\n\nDocument v2.2 §5.6: WHAT is the outcome correlation conjunct.\nVCB does not claim to prove the entire internal system.\nWHAT proves: operational evidence is attributable to this exact passport.","operationId":"what_record_v1_what_record_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/what/retrieve/{sigilmark_id}":{"get":{"tags":["WHAT — Outcome Correlation"],"summary":"What Retrieve","description":"Retrieve a WHAT record by passport sigilmark_id.","operationId":"what_retrieve_v1_what_retrieve__sigilmark_id__get","parameters":[{"name":"sigilmark_id","in":"path","required":true,"schema":{"type":"string","title":"Sigilmark Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidentiary/check":{"post":{"tags":["Evidentiary Sufficiency"],"summary":"Evidentiary Check","description":"Evidentiary Sufficiency check — Q4 in the five-question chain.\n\nVCB does not determine what level of evidence is required.\nVCB examines whether the declared threshold was actually satisfied.\n\nINV-SUFF-01: Provenance/integrity do not establish consequential sufficiency.\nINV-SUFF-02: The threshold must be attributable to a declared authority.\nINV-SUFF-03: Insufficient evidence must not be upgraded to SUFFICIENT.\n\nThe policy owner declares the required evidence profile.\nVCB examines: were those declared requirements actually satisfied?\n\nReturns SUFFICIENT / INSUFFICIENT / NOT_PROVABLE.\nINSUFFICIENT ≠ NOT_PROVABLE.","operationId":"evidentiary_check_v1_evidentiary_check_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-non-mutation-invariant":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Non Mutation Invariant","description":"INV-COMMIT-02: A rejected transition must never mutate consequential state.\nPAYNOVYN INV-007: A rejected transition must never mutate economic state.\n\nTests that every REFUSED result from evaluate_release():\n1. Returns \"state_mutation\": \"NONE\"\n2. Returns a machine-readable primary_code\n3. Does not alter the action_hash, authority_hash, or policy_hash\n4. Returns \"release\": \"REFUSED\" (not a partial state)\n\nThis is a mandatory automated invariant test per the final audit package.","operationId":"test_non_mutation_invariant_v1_engineering_test_non_mutation_invariant_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-paystack-actuator":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Paystack Actuator","description":"P1: Real actuator invariant test — Paystack.\n\nProves: an inadmissible action cannot reach the Paystack payment API.\nAn admissible action can.\n\nUses PAYSTACK_TEST_KEY env var. No real money moves in test mode.\n\nVCB invariant: SATISFIED when:\n- Blocked attempts: paystack_api_called = False (API never touched)\n- Admissible attempt: paystack_api_called = True, reference returned\n- vcb_invariant_holds = True","operationId":"test_paystack_actuator_v1_engineering_test_paystack_actuator_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/env-diagnostic":{"get":{"tags":["Engineering — Adversarial"],"summary":"Env Diagnostic","description":"List all environment variable NAMES visible to the running container.\nValues are NOT returned — only names. Safe to call publicly.\nUse this to diagnose Railway variable injection issues.","operationId":"env_diagnostic_v1_engineering_env_diagnostic_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-replay-protection":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Replay Protection","description":"Foundation Proof Priority 1+2: Persistent replay protection + atomic consumption.\n\nTests INV-P4: A release cannot be replayed beyond its permitted execution semantics.\n\nAdversarial scenarios:\n1. Same release consumed twice in same process (in-memory replay)\n2. Release consumed, then Paystack called — second call blocked\n3. Replay with modified amount — BLOCKED (different action_hash)\n4. Rapid duplicate requests (concurrent replay simulation)","operationId":"test_replay_protection_v1_engineering_test_replay_protection_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/alternate-path-audit":{"get":{"tags":["Engineering — Adversarial"],"summary":"Alternate Path Audit","description":"Foundation Proof Step 5: Alternate-Path Actuator Audit.\n\nClassifies every route in VCB that could reach the Paystack actuator\nor any external consequence boundary.\n\nClassification:\nGOVERNED            — passes through evaluate_release() before actuator\nTEST_ONLY           — engineering/adversarial test endpoint, API-key gated, no real consequence\nWEBHOOK_INBOUND     — receives external callbacks, does not initiate payment\nPAYMENT_ADJACENT    — references payment but does not reach actuator\nDECLARED_OUT_OF_SCOPE — explicitly excluded from consequence path\n\nINV-CONSEQUENCE: Every path capable of reaching a real external consequence\nmust pass through the VCB release gate or be explicitly classified and\ndeclared out of scope.\n\nUNCLASSIFIED_CONSEQUENCE_PATH = ARCHITECTURAL_FAILURE","operationId":"alternate_path_audit_v1_engineering_alternate_path_audit_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/foundation-proof-report":{"get":{"tags":["Engineering — Adversarial"],"summary":"Foundation Proof Report","description":"Foundation Proof v1 — Machine-Verifiable Invariant Report.\n\nStep 6 of the Foundation Proof sequence.\n\nAssembles all evidence into a single signed, offline-verifiable report.\nThis is the artifact that can be independently verified without access\nto the original runtime.\n\nThe report covers:\n- P0: Live STILL gate enforcement\n- P1: Real actuator (Paystack) with INV-P1/P3 adversarially proven\n- P4: Persistent replay protection (Supabase, 6/6)\n- P5: Alternate-path audit (0 unclassified, 0 failures)\n- All core regression suites\n\nSigned with the same Ed25519 key as every VCB passport.","operationId":"foundation_proof_report_v1_engineering_foundation_proof_report_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-post-restart-durability":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Post Restart Durability","description":"Foundation Proof — Post-Restart Durability Test.\n\nProves that authority revocation and consumption state survive process restart.\nRun this AFTER restarting Railway — in-memory state is empty, Supabase is truth.\n\nTest sequence:\n1. Register mandate in Supabase\n2. Revoke mandate in Supabase\n3. Attempt payment — STILL gate must detect REVOKED from Supabase (not memory)\n4. Register fresh mandate\n5. Attempt payment — must succeed (Supabase confirms ACTIVE)\n6. Verify release_records still block replay from pre-restart runs","operationId":"test_post_restart_durability_v1_engineering_test_post_restart_durability_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-multi-instance-atomicity":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Multi Instance Atomicity","description":"Gap 3 — Multi-instance cross-server atomicity.\n\nSimulates two independent instances racing to consume the same release_id\nagainst the shared Supabase store.\n\nThe Supabase UNIQUE constraint on release_records is the enforcement mechanism.\nasyncio.Lock() is per-process only — Supabase UNIQUE is cross-process.\n\nTest design:\n1. Generate a single release_id\n2. Fire N concurrent consume_release_atomic calls bypassing the in-memory lock\n   (simulating calls from different processes that do not share memory)\n3. Required: exactly 1 consumed, N-1 blocked by Supabase UNIQUE constraint\n4. Crash-between-reserve-and-commit: corrupt the in-memory state, retry from Supabase\n5. Verify no double execution possible\n\nThe key invariant being tested:\nEven when two processes both pass the in-memory lock check (because they share\nno memory), the Supabase UNIQUE INSERT ensures only one succeeds.","operationId":"test_multi_instance_atomicity_v1_engineering_test_multi_instance_atomicity_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/diag-insert-once":{"post":{"tags":["Engineering — Adversarial"],"summary":"Diag Insert Once","description":"Diagnostic: test db_insert_once and show raw Supabase response.","operationId":"diag_insert_once_v1_engineering_diag_insert_once_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-continuity-invariants":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Continuity Invariants","description":"CCI / I2S / INV-CONT-01 Adversarial Tests — I, J, K, L\n\nTest I  — Token/execution interruption: checkpoint exists, context changes, resume\nTest J  — Unknown external consequence: actuator called, no response, I2S_ACTIVE\nTest K  — Duplicate resume attack: two resume requests, one checkpoint → exactly one continues\nTest L  — Semantic drift: checkpoint under policy V1, resume under V2 → NOT_PROVABLE\n\nINV-CONT-01: A resumed consequential workflow must not represent itself as\ncontinuous merely because execution resumed. Continuity must be established.","operationId":"test_continuity_invariants_v1_engineering_test_continuity_invariants_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-key-lifecycle":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Key Lifecycle","description":"Key Lifecycle adversarial test — rotation and revocation.\n\nINV-KEY-01: A revoked signing key must not issue new passports.\nINV-KEY-02: Passports signed by a prior key remain verifiable after rotation.\nINV-KEY-03: Key revocation blocks new issuance; existing passports remain intact.\n\nTest sequence:\n1. Issue passport under active key — verify passes\n2. Rotate key — new key active, old key archived\n3. Verify OLD passport under new registry — still verifiable (INV-KEY-02)\n4. Issue NEW passport under rotated key — verify passes\n5. Revoke current key — INV-KEY-01 blocks new issuance\n6. Attempt to issue under revoked key — BLOCKED\n7. Old passports from before revocation still verifiable","operationId":"test_key_lifecycle_v1_engineering_test_key_lifecycle_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sigilmark/persist":{"post":{"tags":["Persistence"],"summary":"Sigilmark Persist Endpoint","description":"Persist a full signed VCB sigilmark (passport) to Supabase.\nReplaces in-memory-only storage — makes passports durable and retrievable.\nRequired for: delegation probes, authority binding tests, restart proofs.\nBody: the complete sigilmark JSON from /v1/vcb/seal or issue_sigilmark().","operationId":"sigilmark_persist_endpoint_v1_sigilmark_persist_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sigilmark/retrieve":{"get":{"tags":["Persistence"],"summary":"Sigilmark Retrieve Endpoint","description":"Retrieve a persisted sigilmark by ID.\nChecks Supabase first (durable), then in-memory cache.\nReturns HALT/NOT_FOUND if not available.\nRequired for: Alkama DP-3/DP-4, delegation lineage verification.","operationId":"sigilmark_retrieve_endpoint_v1_sigilmark_retrieve_get","parameters":[{"name":"sigilmark_id","in":"query","required":true,"schema":{"type":"string","title":"Sigilmark Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/delegation/issue":{"post":{"tags":["Delegation"],"summary":"Delegation Issue","description":"Issue a delegation passport bound to a parent sigilmark.\n\nINV-DELEGATION-01: A delegation must be cryptographically bound to its parent.\nRequired fields:\n  - parent_sigilmark_id: sigilmark_id of the parent authority\n  - delegated_scope: must be a strict subset of parent scope\n  - delegated_ceiling: must be <= parent ceiling\n  - forbidden_propagation: actions the parent forbids cannot appear in child scope\n\nAlkama DP-3 finding: without parent_sigilmark_id, the delegation system\nhas no basis on which to refuse escalated permissions. This endpoint\nrequires explicit parent binding.","operationId":"delegation_issue_v1_delegation_issue_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/principals/register":{"post":{"tags":["P2 — Principal Identity"],"summary":"Register a principal identity record","description":"VGS-PRINCIPAL-1.0 — Register a Principal identity record.\n\nA Principal is the entity whose authority will be evaluated.\nIdentity (who are you?) and Authority (what may you do?) are separate objects.\n\nRequired fields:\n  principal_id   — unique identifier for this principal\n  identity_type  — AI_AGENT | AI_SERVICE | SOFTWARE_SYSTEM | ORGANIZATION | HUMAN | DELEGATED\n\nOptional fields:\n  issuer, verification_material, valid_from, valid_until, identity_evidence","operationId":"principal_register_v1_principals_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/principals/{principal_id}":{"get":{"tags":["P2 — Principal Identity"],"summary":"Get principal status and identity record","description":"VGS-PRINCIPAL-1.0 — Retrieve current principal status.\n\nReturns the principal record including current status (ACTIVE/SUSPENDED/REVOKED/EXPIRED).\nAlso evaluates admissibility: only ACTIVE, non-expired principals may proceed to\nauthority evaluation.\n\nThis is the first gate in the P2 chain:\n  Principal (this endpoint) → Authority → Delegation → Conditions → Action → Gate","operationId":"principal_status_v1_principals__principal_id__get","parameters":[{"name":"principal_id","in":"path","required":true,"schema":{"type":"string","title":"Principal Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authorities/register":{"post":{"tags":["P2 — Authority Record"],"summary":"Register an authority record for a principal","description":"VGS-AUTHORITY-1.0 — Register an Authority Record.\n\nAuthority answers: what may this principal do?\nIdentity (who) and Authority (what) are always separate objects.\n\nRequired fields:\n  authority_id      — unique identifier for this authority record\n  principal_id      — the principal this authority is granted to\n  granted_authority — what authority is being granted\n\nOptional fields:\n  scope, permitted_actions, restricted_actions, ceiling,\n  purpose, conditions, expires_at, evidence","operationId":"authority_register_v1_authorities_register_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authorities/{authority_id}":{"get":{"tags":["P2 — Authority Records"],"summary":"Get authority record","description":"VGS-AUTHORITY-RECORD-1.0 — Retrieve full authority record.","operationId":"authority_get_v1_authorities__authority_id__get","parameters":[{"name":"authority_id","in":"path","required":true,"schema":{"type":"string","title":"Authority Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/authorities/{authority_id}/state":{"get":{"tags":["P2 — Authority Records"],"summary":"Check current authority admissibility state","description":"VGS-AUTHORITY-RECORD-1.0 — Check current authority admissibility.\n\nRe-evaluates admissibility at the moment of the call.\nHistorical authority does not automatically confer current permission.\nPass ?action=<action_type> to check scope admissibility.\n\nThis is the P2 chain:\n  Principal → Authority (this endpoint) → Conditions → Action → Gate","operationId":"authority_state_v1_authorities__authority_id__state_get","parameters":[{"name":"authority_id","in":"path","required":true,"schema":{"type":"string","title":"Authority Id"}},{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-stale-receipt":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Stale Receipt","description":"INV-REC-01 — Stale Receipt / Historical-Validity / Current-Invalidity Test\n\nProves the three inequalities:\n- SIGNATURE_VALID ≠ CURRENTLY_ADMISSIBLE\n- HISTORICAL_PROOF ≠ CURRENT_AUTHORITY\n- CURRENT_AUTHORITY ≠ ADMISSIBLE_CONSEQUENCE\n\nAnd closes ADR-011: STILL gate cannot be bypassed by presenting\na cryptographically valid passport after authority is revoked.\n\nTest sequence:\n1. Register mandate and issue valid sigilmark at T0\n2. Verify: INTEGRITY_VERIFIED + SIGNATURE_VERIFIED (both pass)\n3. Revoke the mandate in Supabase (durable revocation)\n4. Clear in-memory cache (simulate restart — only Supabase knows truth)\n5. Present original valid passport at T1\n6. Attempt release with the original passport's authority\n7. Confirm: INTEGRITY_VERIFIED still passes (artifact unchanged)\n8. Confirm: STILL gate reads Supabase, detects REVOKED, REFUSES\n9. Confirm: Paystack actuator NOT called (consequence boundary held)\n10. Confirm: state_mutation=NONE (INV-COMMIT-02)","operationId":"test_stale_receipt_v1_engineering_test_stale_receipt_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/threat-model":{"get":{"tags":["VCB — Governance"],"summary":"Vcb Threat Model","description":"VCB Formal Threat Model — machine-readable.\nExplicit declaration of what VCB protects against and what it does not.\nThis is the honest enforcement boundary, not a marketing claim.\nIndependent verifiers should read this before attempting adversarial tests.","operationId":"vcb_threat_model_v1_vcb_threat_model_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/claims-registry":{"get":{"tags":["VCB — Governance"],"summary":"Vcb Claims Registry","description":"VCB Machine-Readable Claims Registry — IA-6.\nEvery public claim maps to a test result and a language ceiling.\nThe registry is the canonical source. External text must not exceed this ceiling.","operationId":"vcb_claims_registry_v1_vcb_claims_registry_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/vcb-attack-harness":{"post":{"tags":["Engineering — Adversarial"],"summary":"Vcb Attack Harness","description":"VCB Public Attack Harness — single endpoint for independent adversarial testing.\n\nRuns all adversarial test suites in sequence and returns structured results\nwith INPUT / EXPECTED / OBSERVED / ACTUATOR_CALLED / STATE_MUTATED / EXIT_STATUS\nfor each scenario.\n\nAn independent engineer can run this single endpoint to reproduce all\nrefusal behaviors with standardized output — no private assistance required.\n\nPass paystack_key in the body to include real actuator tests.","operationId":"vcb_attack_harness_v1_engineering_vcb_attack_harness_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/threat-boundary":{"get":{"tags":["Governance — Evidence"],"summary":"Threat Boundary","description":"VCB Formal Threat Boundary — honest in-scope vs out-of-scope declaration.\n\nReturns the machine-readable threat boundary for this VCB deployment.\nThis document is independently examinable and cryptographically signed.\n\nIn-scope threats (VCB enforces against these):\n- Replay of a consumed release through the API\n- Parameter modification after examination (INV-P3)\n- Concurrent duplicate consumption (asyncio.Lock + Supabase UNIQUE)\n- Authority revocation not reflected at commitment (STILL gate, Supabase)\n- Inadmissible action reaching the Paystack actuator (INV-P1)\n- Stale receipt presented after material condition change (INV-REC-01)\n\nOut-of-scope threats (declared, not claimed impossible):\n- Compromised Supabase superuser credentials\n- Direct database writes bypassing the application\n- Compromised Railway container host\n- Compromised SIGN_SECRET environment variable\n- AI model generating false evidence that passes examination\n- Social engineering of the authority granting process","operationId":"threat_boundary_v1_vcb_threat_boundary_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/public-attack-harness":{"get":{"tags":["Engineering — Adversarial"],"summary":"Public Attack Harness","description":"VCB Public Attack Harness — machine-readable test inventory.\n\nReturns the complete list of adversarial tests an independent engineer\ncan run to attempt to break the VCB consequence boundary.\n\nEach test includes:\n- INPUT: what to send\n- EXPECTED: what must happen\n- ENDPOINT: where to run it\n- INVARIANT: which invariant it is testing\n- STATUS: current proof status\n\nAn independent engineer can clone the repo, run these endpoints,\nand reproduce all refusals without private assistance.\nThis is the public reproducibility surface.","operationId":"public_attack_harness_v1_engineering_public_attack_harness_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/claims-consistency":{"get":{"tags":["Governance — Evidence"],"summary":"Claims Consistency","description":"VCB Claims Consistency Check — machine-readable claims registry.\n\nReturns the canonical claims registry with:\n- Each claim mapped to its evidence\n- The language ceiling for each claim\n- Current proof status\n- Whether the claim is consistent with the evidence\n\nThis endpoint is the single source of truth for what VCB claims.\nAll public statements (LinkedIn, AEGF, Zenodo) must map to a row here.\nIf a public statement cannot be mapped to a row in this registry,\nit must not be made.","operationId":"claims_consistency_v1_vcb_claims_consistency_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-canonicalization":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Canonicalization","description":"ADR-014 §17 — Cross-engine canonicalization test.\n\nProves that independent implementations agree on the signed representation.\nAn attacker may attempt to craft a payload that canonicalizes differently\nin the signer vs the verifier, creating a type-coercion or encoding mismatch.\n\nTest cases (per ADR-014 §17):\n- Unicode characters\n- Numeric edge cases (int vs float)\n- Null / omitted fields\n- Key ordering\n- Escape sequences\n- Nested structures\n- Empty string vs None\n\nExpected: signer and jar_verify.py agree on all canonical forms.\nIf they disagree, the verifier would reject a validly signed artifact —\nor worse, accept a tampered one.","operationId":"test_canonicalization_v1_engineering_test_canonicalization_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-silent-exception-audit":{"get":{"tags":["Engineering — Adversarial"],"summary":"Test Silent Exception Audit","description":"ADR-014 §18 — Silent exception / fail-open path audit.\n\nChecks every exception path in the consequence boundary for implicit continuation.\nAn exception that silently continues (no FAIL, no NOT_PROVABLE) is a fail-open.\n\nADR-014 rule:\nIf the system cannot establish a required predicate, it must resolve to:\n- PASS\n- FAIL\n- NOT_PROVABLE\nNo implicit continuation. No silent UNKNOWN → CONTINUE.\n\nTests injected failure scenarios against evaluate_release():\n- Missing examination result\n- Missing consumption result\n- Malformed examination result\n- None authority_id with enforce_still=True\n- Corrupted still result\n- Exception thrown inside still check (simulated)","operationId":"test_silent_exception_audit_v1_engineering_test_silent_exception_audit_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/proof-matrix":{"get":{"tags":["Governance — Evidence"],"summary":"Proof Matrix","description":"ADR-014 §37 — Generated Proof Matrix.\n\nThe Proof Matrix is generated from the Claims Registry.\nIt maps every claim to its invariant, test, artifact, scope, reviewer, and status.\nThis endpoint is the authoritative machine-readable proof surface.\n\nNo manually maintained duplicate table. The registry is the source.\nClaims registry → Proof Matrix is a mechanical relationship, not a manual one.\nDocumentation that contradicts this endpoint is wrong by definition.","operationId":"proof_matrix_v1_vcb_proof_matrix_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-db-authority-integrity":{"get":{"tags":["Engineering — Adversarial"],"summary":"Test Db Authority Integrity","description":"IA-5 — Database authority integrity analysis.\n\nTests what the current database layer enforces and what it does not.\nDocuments the honest threat boundary for the durable store.\n\nADR-014 §9 requirement:\n- Normal application path cannot bypass state-transition invariant\n- Privileged intervention is separately controlled, attributable, auditable\n\nCurrent state:\n- CONSUMED → UNCONSUMED: BLOCKED by application (asyncio.Lock + UNIQUE)\n- CONSUMED → UNCONSUMED via direct Supabase service role: NOT BLOCKED\n  (Postgres trigger not yet implemented)\n- REVOKED → ACTIVE via direct Supabase service role: NOT BLOCKED\n  (Postgres trigger not yet implemented)\n\nRecommended Postgres trigger (not yet implemented):\nCREATE OR REPLACE FUNCTION prevent_consumption_reversal()\nRETURNS trigger AS $$\nBEGIN\n    IF OLD.consumed = true AND NEW.consumed = false THEN\n        RAISE EXCEPTION 'INV-DB-01: consumption reversal is prohibited';\n    END IF;\n    RETURN NEW;\nEND;\n$$ LANGUAGE plpgsql;\n\nCREATE TRIGGER enforce_consumption_immutability\n    BEFORE UPDATE ON release_records\n    FOR EACH ROW EXECUTE FUNCTION prevent_consumption_reversal();\n\nThis converts application-level atomicity into database-level immutability.","operationId":"test_db_authority_integrity_v1_engineering_test_db_authority_integrity_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/test-still-adapter":{"post":{"tags":["Engineering — Adversarial"],"summary":"Test Still Adapter","description":"ADR-014 §15 — STILL Authority Source Adapter adversarial test.\n\nTests 10 adversarial cases against the STILL adapter:\n1. Authority unchanged → STILL_PROVABLE\n2. Authority revoked → STILL_FAILED\n3. Authority expired → STILL_FAILED (status=EXPIRED)\n4. Amount exceeds current ceiling → STILL_FAILED\n5. Vendor not in current authorized list → STILL_FAILED\n6. Authority not found → STILL_NOT_PROVABLE\n7. Source unavailable (simulated) → STILL_NOT_PROVABLE\n8. Caller-forged STILL result → IGNORED (adapter result takes precedence)\n9. STILL_NOT_PROVABLE never produces RELEASE_GRANTED\n10. STILL_FAILED never produces RELEASE_GRANTED\n\nCritical test (ADR-014 §15):\nAttacker supplies STILL_PROVABLE while the real authority source says otherwise.\nThe gate must ignore the forged caller state — adapter is authoritative.","operationId":"test_still_adapter_v1_engineering_test_still_adapter_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/vcb/database-integrity-spec":{"get":{"tags":["Governance — Evidence"],"summary":"Database Integrity Spec","description":"IA-5 — Database Authority Integrity Specification.\n\nADR-014 §9: The database layer must be treated as part of the security boundary.\nThe system must not claim that application-level atomicity equals database-level\nimmutability. This endpoint documents the honest current state and the recommended\nPostgres-level hardening.\n\nCurrent state: application-level atomicity (asyncio.Lock + Supabase UNIQUE).\nRecommended hardener: Postgres trigger preventing CONSUMED→UNCONSUMED reversion.\nStatus: trigger SQL provided below — not yet applied to production Supabase.","operationId":"database_integrity_spec_v1_vcb_database_integrity_spec_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/engineering/master-audit":{"get":{"tags":["Engineering Gates 0-7"],"summary":"Engineering Master Audit","description":"Master Audit Object — single authoritative status of the entire VCB architecture.\nExposes all frozen constants, proof properties, invariants, build order, and current status.\nNo auth required.","operationId":"engineering_master_audit_v1_engineering_master_audit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/delegation/passport/revoke/{agent_id}":{"post":{"tags":["Terry Bounded Adversarial Validation"],"summary":"Revoke Delegation For Validation","operationId":"revoke_delegation_for_validation_v1_delegation_passport_revoke__agent_id__post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}}},"components":{"schemas":{"AREtABARequest":{"properties":{"allowed_action":{"type":"string","title":"Allowed Action"},"max_amount_usd":{"type":"number","title":"Max Amount Usd","default":0},"consequence_level":{"type":"string","title":"Consequence Level","default":"MEDIUM"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"}},"type":"object","required":["allowed_action"],"title":"AREtABARequest"},"ATFDRRequest":{"properties":{"delegation_id":{"type":"string","title":"Delegation Id"},"delegator_id":{"type":"string","title":"Delegator Id"},"delegate_id":{"type":"string","title":"Delegate Id"},"task_scope":{"additionalProperties":true,"type":"object","title":"Task Scope"},"authority_budget_delegator":{"type":"number","title":"Authority Budget Delegator"},"authority_budget_granted":{"type":"number","title":"Authority Budget Granted"},"parent_delegation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Delegation Id"},"chain_root_id":{"type":"string","title":"Chain Root Id"},"delegation_depth":{"type":"integer","title":"Delegation Depth"},"delegator_public_key":{"type":"string","title":"Delegator Public Key","default":""},"content_hash":{"type":"string","title":"Content Hash","default":""},"posture_state_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posture State Hash"},"pqc_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pqc Signature"},"pqc_algorithm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pqc Algorithm"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"status":{"type":"string","title":"Status","default":"ACTIVE"},"created_at":{"type":"string","title":"Created At","default":""},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"type":"object","required":["delegation_id","delegator_id","delegate_id","task_scope","authority_budget_delegator","authority_budget_granted","chain_root_id","delegation_depth"],"title":"ATFDRRequest"},"ATFDelegationReceiptRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"delegator_id":{"type":"string","title":"Delegator Id"},"authority_budget_delegator":{"type":"number","title":"Authority Budget Delegator","default":1.0},"authority_budget_granted":{"type":"number","title":"Authority Budget Granted","default":0.7},"delegated_scope":{"items":{},"type":"array","title":"Delegated Scope","default":["read","execute"]},"originating_scope":{"items":{},"type":"array","title":"Originating Scope","default":["read","write","execute","delegate"]},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"chain_root_id":{"type":"string","title":"Chain Root Id","default":""}},"type":"object","required":["agent_id","delegator_id"],"title":"ATFDelegationReceiptRequest"},"ATFRCRRequest":{"properties":{"rcr_id":{"type":"string","title":"Rcr Id"},"tar_id":{"type":"string","title":"Tar Id"},"delegation_id":{"type":"string","title":"Delegation Id"},"chain_root_id":{"type":"string","title":"Chain Root Id"},"agent_id":{"type":"string","title":"Agent Id"},"ces_score":{"type":"number","title":"Ces Score"},"continuity_status":{"type":"string","title":"Continuity Status"},"ces_temporal":{"type":"number","title":"Ces Temporal"},"ces_budget":{"type":"number","title":"Ces Budget"},"ces_context":{"type":"number","title":"Ces Context"},"ces_integrity":{"type":"number","title":"Ces Integrity"},"execution_ns":{"type":"integer","title":"Execution Ns","default":0},"execution_ts":{"type":"string","title":"Execution Ts","default":""},"issued_at":{"type":"string","title":"Issued At"},"budget_at_admission":{"type":"number","title":"Budget At Admission","default":0.0},"budget_remaining":{"type":"number","title":"Budget Remaining","default":0.0},"context_drift_pct":{"type":"number","title":"Context Drift Pct","default":0.0},"active_anomalies":{"type":"integer","title":"Active Anomalies","default":0},"time_remaining_ns":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Time Remaining Ns"},"dr_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dr Expires At"},"fragmentation_score":{"type":"number","title":"Fragmentation Score","default":0.0},"reauth_challenge_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reauth Challenge Id"},"content_hash":{"type":"string","title":"Content Hash","default":""},"pqc_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pqc Signature"},"pqc_algorithm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pqc Algorithm"},"sample_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample Reason"},"escalation_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalation Event Id"},"predecessor_rcr_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Predecessor Rcr Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"type":"object","required":["rcr_id","tar_id","delegation_id","chain_root_id","agent_id","ces_score","continuity_status","ces_temporal","ces_budget","ces_context","ces_integrity","issued_at"],"title":"ATFRCRRequest"},"ATFTARRequest":{"properties":{"tar_id":{"type":"string","title":"Tar Id"},"delegation_id":{"type":"string","title":"Delegation Id"},"agent_id":{"type":"string","title":"Agent Id"},"execution_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Ref"},"execution_ns":{"type":"integer","title":"Execution Ns"},"execution_ts":{"type":"string","title":"Execution Ts"},"dr_status_at_admission":{"type":"string","title":"Dr Status At Admission","default":"ACTIVE"},"dr_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dr Expires At"},"authority_budget":{"type":"number","title":"Authority Budget"},"domain":{"type":"string","title":"Domain"},"task_action":{"type":"string","title":"Task Action"},"admission_status":{"type":"string","title":"Admission Status","default":"ADMITTED"},"rejection_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rejection Reason"},"content_hash":{"type":"string","title":"Content Hash","default":""},"pqc_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pqc Signature"},"pqc_algorithm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pqc Algorithm"},"chain_root_id":{"type":"string","title":"Chain Root Id"},"issued_at":{"type":"string","title":"Issued At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"type":"object","required":["tar_id","delegation_id","agent_id","execution_ns","execution_ts","authority_budget","domain","task_action","chain_root_id","issued_at"],"title":"ATFTARRequest"},"ActionEvaluateRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"risk_level":{"type":"string","title":"Risk Level"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","default":"production"}},"type":"object","required":["agent_id","action_type","risk_level"],"title":"ActionEvaluateRequest"},"AdmissibilityDiagRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"execution_ns":{"type":"integer","title":"Execution Ns","default":0},"authority_age_s":{"type":"number","title":"Authority Age S","default":0.0},"continuity_breaks":{"type":"integer","title":"Continuity Breaks","default":0},"post_escalation":{"type":"boolean","title":"Post Escalation","default":false},"domain":{"type":"string","title":"Domain","default":"general"}},"type":"object","required":["agent_id","action_type"],"title":"AdmissibilityDiagRequest"},"AdmissibilityRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"current_state":{"type":"string","title":"Current State","default":"EXECUTING"},"authority_scope":{"items":{},"type":"array","title":"Authority Scope","default":[]},"consequence_class":{"type":"string","title":"Consequence Class","default":"OPERATIONAL"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"tools_invoked":{"items":{},"type":"array","title":"Tools Invoked","default":[]},"external_systems":{"items":{},"type":"array","title":"External Systems","default":[]},"irreversible":{"type":"boolean","title":"Irreversible","default":false},"workflow_step":{"type":"integer","title":"Workflow Step","default":1},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"human_present":{"type":"boolean","title":"Human Present","default":false},"prior_admissibility_id":{"type":"string","title":"Prior Admissibility Id","default":""}},"type":"object","required":["agent_id","action_type"],"title":"AdmissibilityRequest","description":"The core primitive. Everything else attaches to this.\nContinuous admissibility determination at runtime."},"AdmissibilityTranslationRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"source_jurisdiction":{"type":"string","title":"Source Jurisdiction","default":"US"},"target_jurisdiction":{"type":"string","title":"Target Jurisdiction","default":"EU"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"original_decision":{"type":"string","title":"Original Decision","default":"ALLOW"}},"type":"object","required":["agent_id","action_type"],"title":"AdmissibilityTranslationRequest"},"AdversarialRiskRequest":{"properties":{"trust_score":{"type":"number","title":"Trust Score","default":0.963},"provenance_score":{"type":"number","title":"Provenance Score","default":1.0},"jurisdiction_conflict":{"type":"boolean","title":"Jurisdiction Conflict","default":false},"split_training_detected":{"type":"boolean","title":"Split Training Detected","default":false},"unregulated_zone":{"type":"boolean","title":"Unregulated Zone","default":false},"behavioral_anomaly":{"type":"number","title":"Behavioral Anomaly","default":0.0}},"type":"object","title":"AdversarialRiskRequest"},"AgentHandshakeRequest":{"properties":{"requesting_agent_id":{"type":"string","title":"Requesting Agent Id"},"target_agent_id":{"type":"string","title":"Target Agent Id"},"requested_scope":{"items":{},"type":"array","title":"Requested Scope","default":[]},"interaction_type":{"type":"string","title":"Interaction Type","default":"data_exchange"},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"workflow_id":{"type":"string","title":"Workflow Id","default":""}},"additionalProperties":false,"type":"object","required":["requesting_agent_id","target_agent_id"],"title":"AgentHandshakeRequest"},"AgentStateUpdateRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"new_state":{"type":"string","title":"New State"},"reason":{"type":"string","title":"Reason","default":""},"trust_score":{"type":"number","title":"Trust Score"},"action_type":{"type":"string","title":"Action Type","default":""}},"type":"object","required":["agent_id","new_state"],"title":"AgentStateUpdateRequest"},"AgentTrustRegisterRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"type":"string","title":"Agent Name","default":""},"agent_type":{"type":"string","title":"Agent Type","default":"general"},"authority_scope":{"items":{},"type":"array","title":"Authority Scope","default":[]},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"org_id":{"type":"string","title":"Org Id","default":""},"trust_level":{"type":"string","title":"Trust Level","default":"STANDARD"}},"additionalProperties":false,"type":"object","required":["agent_id"],"title":"AgentTrustRegisterRequest"},"AlignmentSnapshotRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"snapshot_type":{"type":"string","title":"Snapshot Type","default":"PERIODIC"},"behavioral_hash":{"type":"string","title":"Behavioral Hash","default":""},"authority_vector":{"additionalProperties":true,"type":"object","title":"Authority Vector","default":{}},"drift_indicators":{"items":{},"type":"array","title":"Drift Indicators","default":[]},"attestation_source":{"type":"string","title":"Attestation Source","default":""}},"type":"object","required":["agent_id"],"title":"AlignmentSnapshotRequest"},"AnnexIIIRequest":{"properties":{"intended_use":{"type":"string","title":"Intended Use"},"use_case":{"type":"string","title":"Use Case"},"profiles_individuals":{"type":"boolean","title":"Profiles Individuals","default":false},"materially_influences_outcome":{"type":"boolean","title":"Materially Influences Outcome","default":true}},"type":"object","required":["intended_use","use_case"],"title":"AnnexIIIRequest"},"ApprovalCreate":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"action_details":{"additionalProperties":true,"type":"object","title":"Action Details","default":{}},"resource":{"type":"string","title":"Resource"},"trust_score":{"type":"number","title":"Trust Score"},"reason":{"type":"string","title":"Reason"},"approver_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approver Email"}},"type":"object","required":["execution_id","agent_id","action_type","resource","trust_score","reason"],"title":"ApprovalCreate"},"ApprovalDecision":{"properties":{"decision":{"type":"string","title":"Decision"},"approver_name":{"type":"string","title":"Approver Name"},"approver_email":{"type":"string","title":"Approver Email"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["decision","approver_name","approver_email"],"title":"ApprovalDecision"},"ApprovalRequest":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"approver_id":{"type":"string","title":"Approver Id"},"approver_role":{"type":"string","title":"Approver Role"},"decision":{"type":"string","title":"Decision","default":"APPROVED"},"reasoning":{"type":"string","title":"Reasoning","default":""},"authority_claim":{"type":"string","title":"Authority Claim","default":""}},"type":"object","required":["workflow_id","approver_id","approver_role"],"title":"ApprovalRequest"},"AttackSimRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"target_text":{"type":"string","title":"Target Text","default":""},"attack_types":{"items":{},"type":"array","title":"Attack Types","default":[]},"domain":{"type":"string","title":"Domain","default":"general"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"iterations":{"type":"integer","title":"Iterations","default":1}},"type":"object","required":["agent_id"],"title":"AttackSimRequest"},"AttentionGovernanceRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"declared_priorities":{"items":{},"type":"array","title":"Declared Priorities","default":[]},"action_context":{"type":"string","title":"Action Context","default":""},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["agent_id"],"title":"AttentionGovernanceRequest"},"AuthorityContinuityRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"authority_chain":{"items":{},"type":"array","title":"Authority Chain","default":[]},"initial_scope":{"items":{},"type":"array","title":"Initial Scope","default":[]},"current_scope":{"items":{},"type":"array","title":"Current Scope","default":[]},"state_transitions":{"items":{},"type":"array","title":"State Transitions","default":[]},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"}},"type":"object","required":["agent_id"],"title":"AuthorityContinuityRequest"},"AuthorityDeclareRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"authority_claims":{"items":{},"type":"array","title":"Authority Claims"},"scope":{"type":"string","title":"Scope","default":"TASK"},"delegation_depth":{"type":"integer","title":"Delegation Depth","default":0},"expires_seconds":{"type":"integer","title":"Expires Seconds","default":86400},"grantor":{"type":"string","title":"Grantor","default":""}},"type":"object","required":["agent_id","authority_claims"],"title":"AuthorityDeclareRequest"},"AuthorityTopologyRequest":{"properties":{"org_id":{"type":"string","title":"Org Id"},"nodes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Edges","default":[]},"workflow_id":{"type":"string","title":"Workflow Id","default":""}},"type":"object","required":["org_id"],"title":"AuthorityTopologyRequest"},"BatchVerifyRequest":{"properties":{"documents":{"items":{},"type":"array","title":"Documents"},"agent_id":{"type":"string","title":"Agent Id","default":"ai-agent-001"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"type":"object","required":["documents"],"title":"BatchVerifyRequest"},"BehavioralContractRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"bic_id":{"type":"string","title":"Bic Id"},"max_drift_threshold":{"type":"number","title":"Max Drift Threshold","default":0.15},"review_interval_days":{"type":"integer","title":"Review Interval Days","default":30},"stakeholder_ids":{"items":{},"type":"array","title":"Stakeholder Ids","default":[]},"org_id":{"type":"string","title":"Org Id","default":""},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"additionalProperties":false,"type":"object","required":["agent_id","bic_id"],"title":"BehavioralContractRequest"},"BehavioralDriftRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"live_outputs":{"items":{},"type":"array","title":"Live Outputs","default":[]},"baseline_bic_id":{"type":"string","title":"Baseline Bic Id","default":""},"threshold":{"type":"number","title":"Threshold","default":0.15},"org_id":{"type":"string","title":"Org Id","default":""},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"additionalProperties":false,"type":"object","required":["agent_id"],"title":"BehavioralDriftRequest"},"BehavioralFingerprintRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"model_version":{"type":"string","title":"Model Version","default":""},"probe_outputs":{"items":{},"type":"array","title":"Probe Outputs","default":[]},"probe_category":{"type":"string","title":"Probe Category","default":"GENERAL"},"org_id":{"type":"string","title":"Org Id","default":""},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"additionalProperties":false,"type":"object","required":["agent_id"],"title":"BehavioralFingerprintRequest"},"Body_issue_cdpr_v1_conformance_verify_post":{"properties":{"provenance_chain":{"items":{},"type":"array","title":"Provenance Chain"}},"type":"object","required":["provenance_chain"],"title":"Body_issue_cdpr_v1_conformance_verify_post"},"Body_rootcause_trace_v1_rootcause_trace_post":{"properties":{"contributing_factors":{"items":{},"type":"array","title":"Contributing Factors","default":[]}},"type":"object","title":"Body_rootcause_trace_v1_rootcause_trace_post"},"BreakGlassRequest":{"properties":{"action_type":{"type":"string","title":"Action Type"},"agent_id":{"type":"string","title":"Agent Id"},"override_reason":{"type":"string","title":"Override Reason"},"authorising_human":{"type":"string","title":"Authorising Human"},"incident_id":{"type":"string","title":"Incident Id"},"consequence_tier":{"type":"string","title":"Consequence Tier","default":"EMERGENCY"}},"type":"object","required":["action_type","agent_id","override_reason","authorising_human","incident_id"],"title":"BreakGlassRequest"},"BridgeValidateRequest":{"properties":{"dr":{"additionalProperties":true,"type":"object","title":"Dr"},"tar":{"additionalProperties":true,"type":"object","title":"Tar"},"rcr":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Rcr"}},"type":"object","required":["dr","tar"],"title":"BridgeValidateRequest"},"BusEventRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"session_id":{"type":"string","title":"Session Id"},"action":{"type":"string","title":"Action"},"input_hash":{"type":"string","title":"Input Hash","default":""},"output_hash":{"type":"string","title":"Output Hash","default":""},"org_id":{"type":"string","title":"Org Id","default":""},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"additionalProperties":false,"type":"object","required":["agent_id","session_id","action"],"title":"BusEventRequest"},"BusVerifyRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"claim":{"type":"string","title":"Claim"},"agent_id":{"type":"string","title":"Agent Id","default":""},"org_id":{"type":"string","title":"Org Id","default":""}},"additionalProperties":false,"type":"object","required":["session_id","claim"],"title":"BusVerifyRequest"},"CDPRRequest":{"properties":{"cdpr_id":{"type":"string","title":"Cdpr Id","default":""},"from_agent":{"type":"string","title":"From Agent"},"to_agent":{"type":"string","title":"To Agent"},"from_domain":{"type":"string","title":"From Domain","default":"VGS"},"to_domain":{"type":"string","title":"To Domain","default":"ATF"},"from_artifact_id":{"type":"string","title":"From Artifact Id","default":""},"to_artifact_id":{"type":"string","title":"To Artifact Id","default":""},"from_artifact_type":{"type":"string","title":"From Artifact Type","default":"GDR"},"to_artifact_type":{"type":"string","title":"To Artifact Type","default":"DR"},"provenance_chain":{"items":{},"type":"array","title":"Provenance Chain","default":[]},"workflow_id":{"type":"string","title":"Workflow Id","default":""}},"type":"object","required":["from_agent","to_agent"],"title":"CDPRRequest"},"CRIRequest":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"affected_parties":{"type":"integer","title":"Affected Parties","default":1},"financial_impact":{"type":"number","title":"Financial Impact","default":0.0},"reversible":{"type":"boolean","title":"Reversible","default":true},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"propagation_depth":{"type":"integer","title":"Propagation Depth","default":3},"human_dependency":{"type":"number","title":"Human Dependency","default":0.5},"domain":{"type":"string","title":"Domain","default":"general"}},"type":"object","required":["execution_id","agent_id","action_type"],"title":"CRIRequest"},"CROBoardReportRequest":{"properties":{"institution_name":{"type":"string","title":"Institution Name"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"AU"},"period":{"type":"string","title":"Period","default":"2026-Q2"}},"type":"object","required":["institution_name"],"title":"CROBoardReportRequest"},"CalibrationRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"survivability_score":{"type":"number","title":"Survivability Score","default":0.8},"semantic_certainty":{"type":"number","title":"Semantic Certainty","default":0.85},"runtime_integrity":{"type":"number","title":"Runtime Integrity","default":0.9},"escalation_count":{"type":"integer","title":"Escalation Count","default":0},"domain":{"type":"string","title":"Domain","default":"general"}},"type":"object","required":["agent_id"],"title":"CalibrationRequest"},"CausalityRequest":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"parent_execution":{"type":"string","title":"Parent Execution","default":""},"authority_source":{"type":"string","title":"Authority Source","default":""},"consequence_class":{"type":"string","title":"Consequence Class","default":"MEDIUM"},"downstream_agents":{"items":{},"type":"array","title":"Downstream Agents","default":[]},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}}},"type":"object","required":["execution_id","agent_id","action_type"],"title":"CausalityRequest"},"ChainCallRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"caller_id":{"type":"string","title":"Caller Id"},"callee_id":{"type":"string","title":"Callee Id"},"action":{"type":"string","title":"Action"},"decision":{"type":"string","title":"Decision"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"risk_class":{"type":"string","title":"Risk Class","default":"LOW"}},"type":"object","required":["chain_id","caller_id","callee_id","action","decision"],"title":"ChainCallRequest"},"ChainContextCreateRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"workflow_id":{"type":"string","title":"Workflow Id","default":""},"initial_consequence":{"type":"string","title":"Initial Consequence","default":"OPERATIONAL"},"authority_scope":{"items":{},"type":"array","title":"Authority Scope","default":[]},"human_present":{"type":"boolean","title":"Human Present","default":false},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"description":{"type":"string","title":"Description","default":""}},"additionalProperties":false,"type":"object","required":["agent_id"],"title":"ChainContextCreateRequest"},"ChainEvaluateRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"step_number":{"type":"integer","title":"Step Number","default":1},"payload_hash":{"type":"string","title":"Payload Hash","default":""},"tools_requested":{"items":{},"type":"array","title":"Tools Requested","default":[]},"external_systems":{"items":{},"type":"array","title":"External Systems","default":[]},"irreversible":{"type":"boolean","title":"Irreversible","default":false},"human_present":{"type":"boolean","title":"Human Present","default":false}},"additionalProperties":false,"type":"object","required":["chain_id","agent_id","action_type"],"title":"ChainEvaluateRequest"},"ChainInterceptRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"step_number":{"type":"integer","title":"Step Number","default":1},"payload_hash":{"type":"string","title":"Payload Hash","default":""},"tools_requested":{"items":{},"type":"array","title":"Tools Requested","default":[]},"external_systems":{"items":{},"type":"array","title":"External Systems","default":[]},"irreversible":{"type":"boolean","title":"Irreversible","default":false},"human_present":{"type":"boolean","title":"Human Present","default":false},"signal_type":{"type":"string","title":"Signal Type","default":""},"signal_data":{"additionalProperties":true,"type":"object","title":"Signal Data","default":{}}},"additionalProperties":false,"type":"object","required":["chain_id","agent_id","action_type"],"title":"ChainInterceptRequest"},"ChainSignalRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"signal_type":{"type":"string","title":"Signal Type"},"signal_data":{"additionalProperties":true,"type":"object","title":"Signal Data","default":{}},"step_number":{"type":"integer","title":"Step Number","default":1},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"additionalProperties":false,"type":"object","required":["chain_id","agent_id","action_type","signal_type"],"title":"ChainSignalRequest"},"ChipVerifyRequest":{"properties":{"serial_number":{"type":"string","title":"Serial Number"},"chip_type":{"type":"string","title":"Chip Type","default":"GENERIC_GPU"},"deployment_country":{"type":"string","title":"Deployment Country","default":"US"},"claimed_purchaser":{"type":"string","title":"Claimed Purchaser","default":""}},"type":"object","required":["serial_number"],"title":"ChipVerifyRequest"},"ClauseMutationRequest":{"properties":{"document_id":{"type":"string","title":"Document Id","default":"doc-001"},"original_text":{"type":"string","title":"Original Text"},"current_text":{"type":"string","title":"Current Text","default":""},"generated_text":{"type":"string","title":"Generated Text","default":""},"document_type":{"type":"string","title":"Document Type","default":"legal_contract"},"agent_id":{"type":"string","title":"Agent Id","default":"agent-001"}},"type":"object","required":["original_text"],"title":"ClauseMutationRequest"},"CognitionIntegrityRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"model_id":{"type":"string","title":"Model Id","default":""},"output_text":{"type":"string","title":"Output Text"},"domain":{"type":"string","title":"Domain","default":"general"},"training_sources":{"items":{},"type":"array","title":"Training Sources","default":[]},"known_safe_outputs":{"items":{},"type":"array","title":"Known Safe Outputs","default":[]}},"type":"object","required":["agent_id","output_text"],"title":"CognitionIntegrityRequest"},"CognitiveAdmissibilityRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"response_content":{"type":"string","title":"Response Content"},"intended_domain":{"type":"string","title":"Intended Domain","default":"OPERATIONAL"},"agent_authority":{"items":{},"type":"array","title":"Agent Authority","default":[]},"certainty_claim":{"type":"string","title":"Certainty Claim","default":"MODERATE"},"audience_type":{"type":"string","title":"Audience Type","default":"PROFESSIONAL"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"has_human_oversight":{"type":"boolean","title":"Has Human Oversight","default":false}},"type":"object","required":["agent_id","response_content"],"title":"CognitiveAdmissibilityRequest"},"CognitiveChallengeRequest":{"properties":{"reviewer_id":{"type":"string","title":"Reviewer Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"domain":{"type":"string","title":"Domain","default":"general"},"challenge_type":{"type":"string","title":"Challenge Type","default":"mandatory_challenge"},"response":{"type":"string","title":"Response","default":""}},"type":"object","required":["reviewer_id","agent_id","action_type"],"title":"CognitiveChallengeRequest"},"CognitiveGovernanceRequest":{"properties":{"decision":{"type":"string","title":"Decision"},"confidence":{"type":"number","title":"Confidence"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons","default":[]},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence","default":{}},"action_type":{"type":"string","title":"Action Type","default":"payment"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["decision","confidence"],"title":"CognitiveGovernanceRequest"},"CommitmentRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"agent_id":{"type":"string","title":"Agent Id"},"commitment_type":{"type":"string","title":"Commitment Type"},"amount_usd":{"type":"number","title":"Amount Usd","default":0},"irreversible":{"type":"boolean","title":"Irreversible","default":false},"rollback_window_secs":{"type":"number","title":"Rollback Window Secs","default":300.0}},"type":"object","required":["chain_id","agent_id","commitment_type"],"title":"CommitmentRequest"},"CompetencyAssertRequest":{"properties":{"reviewer_id":{"type":"string","title":"Reviewer Id"},"certifications":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Certifications","default":[]},"authority_scope":{"items":{"type":"string"},"type":"array","title":"Authority Scope","default":[]},"consequence_level_match":{"type":"boolean","title":"Consequence Level Match","default":true},"last_training_completion":{"type":"string","title":"Last Training Completion","default":""}},"type":"object","required":["reviewer_id"],"title":"CompetencyAssertRequest"},"ComplianceReq":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"regulations":{"items":{"type":"string"},"type":"array","title":"Regulations","default":["eu_ai_act","gdpr","hipaa","soc2"]}},"type":"object","required":["agent_id"],"title":"ComplianceReq"},"ComputeProvenanceRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"serial_numbers":{"items":{},"type":"array","title":"Serial Numbers","default":[]},"claimed_owner":{"type":"string","title":"Claimed Owner","default":""},"infrastructure":{"type":"string","title":"Infrastructure","default":"unknown"},"deployment_country":{"type":"string","title":"Deployment Country","default":"US"}},"type":"object","required":["agent_id"],"title":"ComputeProvenanceRequest"},"ConsequenceClassifyRequest":{"properties":{"action_type":{"type":"string","title":"Action Type"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"agent_id":{"type":"string","title":"Agent Id","default":""},"reversible":{"type":"boolean","title":"Reversible","default":true},"affects_humans":{"type":"boolean","title":"Affects Humans","default":false},"regulatory_scope":{"items":{"type":"string"},"type":"array","title":"Regulatory Scope","default":[]}},"type":"object","required":["action_type"],"title":"ConsequenceClassifyRequest"},"ConsequenceSimRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"domain":{"type":"string","title":"Domain","default":"general"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"affected_parties":{"type":"integer","title":"Affected Parties","default":1},"financial_impact":{"type":"number","title":"Financial Impact","default":0.0},"reversible":{"type":"boolean","title":"Reversible","default":true},"depth":{"type":"integer","title":"Depth","default":3}},"type":"object","required":["agent_id","action_type"],"title":"ConsequenceSimRequest"},"ContainmentZoneRequest":{"properties":{"zone_name":{"type":"string","title":"Zone Name"},"agent_ids":{"items":{},"type":"array","title":"Agent Ids","default":[]},"max_consequence":{"type":"string","title":"Max Consequence","default":"MEDIUM"},"max_concurrent":{"type":"integer","title":"Max Concurrent","default":5},"blast_radius_limit":{"type":"integer","title":"Blast Radius Limit","default":100},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"auto_kill":{"type":"boolean","title":"Auto Kill","default":true}},"type":"object","required":["zone_name"],"title":"ContainmentZoneRequest"},"ContaminationRequest":{"properties":{"mem_id":{"type":"string","title":"Mem Id"},"new_content_hash":{"type":"string","title":"New Content Hash","default":""},"injection_signals":{"items":{},"type":"array","title":"Injection Signals","default":[]},"drift_score":{"type":"number","title":"Drift Score","default":0.0}},"type":"object","required":["mem_id"],"title":"ContaminationRequest"},"ContextGovernanceRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"algorithm_name":{"type":"string","title":"Algorithm Name","default":""},"algorithm_version":{"type":"string","title":"Algorithm Version","default":""},"data_sources":{"items":{},"type":"array","title":"Data Sources","default":[]},"data_provenance":{"additionalProperties":true,"type":"object","title":"Data Provenance","default":{}},"semantic_boundary":{"type":"string","title":"Semantic Boundary","default":""},"context_hash":{"type":"string","title":"Context Hash","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"}},"type":"object","required":["agent_id"],"title":"ContextGovernanceRequest"},"ContinuousCheckRequest":{"properties":{"monitor_id":{"type":"string","title":"Monitor Id"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"context":{"additionalProperties":true,"type":"object","title":"Context","default":{}}},"type":"object","required":["monitor_id"],"title":"ContinuousCheckRequest"},"CoordinationChainRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"origin_system":{"type":"string","title":"Origin System"},"decision_sequence":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Decision Sequence","default":[]},"governance_requirements":{"additionalProperties":true,"type":"object","title":"Governance Requirements","default":{}}},"type":"object","required":["chain_id","origin_system"],"title":"CoordinationChainRequest"},"CorrectiveActionRequest":{"properties":{"nc_id":{"type":"string","title":"Nc Id"},"action_description":{"type":"string","title":"Action Description"},"responsible_party":{"type":"string","title":"Responsible Party"},"target_date":{"type":"string","title":"Target Date","default":""},"action_type":{"type":"string","title":"Action Type","default":"CORRECTIVE"}},"type":"object","required":["nc_id","action_description","responsible_party"],"title":"CorrectiveActionRequest"},"CriminalViolationRequest":{"properties":{"agent_did":{"type":"string","title":"Agent Did"},"violation_type":{"type":"string","title":"Violation Type"},"severity":{"type":"string","title":"Severity","default":"MEDIUM"},"description":{"type":"string","title":"Description"},"action_taken":{"type":"string","title":"Action Taken","default":"LOGGED"},"evidence_id":{"type":"string","title":"Evidence Id","default":""}},"type":"object","required":["agent_did","violation_type","description"],"title":"CriminalViolationRequest"},"CrossAgentMemoryRequest":{"properties":{"mem_id":{"type":"string","title":"Mem Id"},"from_agent_id":{"type":"string","title":"From Agent Id"},"to_agent_id":{"type":"string","title":"To Agent Id"},"delegation_scope":{"items":{},"type":"array","title":"Delegation Scope","default":["read"]},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"type":"object","required":["mem_id","from_agent_id","to_agent_id"],"title":"CrossAgentMemoryRequest"},"CryptoVerifyRequest":{"properties":{"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"signature":{"type":"string","title":"Signature"}},"type":"object","required":["payload","signature"],"title":"CryptoVerifyRequest"},"CustomsRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"target_domain":{"type":"string","title":"Target Domain"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}}},"type":"object","required":["agent_id","action_type","target_domain"],"title":"CustomsRequest"},"DCGValidateRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Steps","default":[]},"workflow_id":{"type":"string","title":"Workflow Id","default":""}},"type":"object","required":["chain_id"],"title":"DCGValidateRequest"},"DNARequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"creator_id":{"type":"string","title":"Creator Id"},"lineage":{"items":{},"type":"array","title":"Lineage","default":[]},"capability_class":{"type":"string","title":"Capability Class","default":"READ_ONLY"},"inherited_constraints":{"items":{},"type":"array","title":"Inherited Constraints","default":[]},"governance_version":{"type":"string","title":"Governance Version","default":"VGS-1.0"}},"type":"object","required":["agent_id","creator_id"],"title":"DNARequest"},"DataConsentRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"data_sources":{"items":{},"type":"array","title":"Data Sources","default":[]},"consent_records":{"additionalProperties":true,"type":"object","title":"Consent Records","default":{}},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"processing_purpose":{"type":"string","title":"Processing Purpose","default":""}},"type":"object","required":["agent_id"],"title":"DataConsentRequest"},"DataContaminationRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"training_sources":{"items":{},"type":"array","title":"Training Sources","default":[]},"known_biases":{"items":{},"type":"array","title":"Known Biases","default":[]},"contamination_flags":{"items":{},"type":"array","title":"Contamination Flags","default":[]},"domain":{"type":"string","title":"Domain","default":"general"}},"type":"object","required":["agent_id"],"title":"DataContaminationRequest"},"DataFreshnessRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"data_cutoff_date":{"type":"string","title":"Data Cutoff Date","default":""},"knowledge_sources":{"items":{},"type":"array","title":"Knowledge Sources","default":[]},"domain":{"type":"string","title":"Domain","default":"general"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["agent_id"],"title":"DataFreshnessRequest"},"DeclarationObligationRequest":{"properties":{"obligation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Obligation Id"},"originating_event_hash":{"type":"string","title":"Originating Event Hash"},"affected_scope":{"type":"string","title":"Affected Scope"},"responsible_identity":{"type":"string","title":"Responsible Identity"},"responsible_role":{"type":"string","title":"Responsible Role"},"materiality_rule":{"type":"string","title":"Materiality Rule"},"basis_evidence":{"additionalProperties":true,"type":"object","title":"Basis Evidence"},"deadline_hours":{"type":"integer","title":"Deadline Hours","default":72},"escalation_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalation Identity"}},"type":"object","required":["originating_event_hash","affected_scope","responsible_identity","responsible_role","materiality_rule","basis_evidence"],"title":"DeclarationObligationRequest","description":"Open a Declaration Obligation when a materiality threshold is crossed."},"DelegationAddRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"from_agent":{"type":"string","title":"From Agent"},"to_agent":{"type":"string","title":"To Agent"},"to_trust":{"type":"number","title":"To Trust","default":0.963},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""}},"type":"object","required":["chain_id","from_agent","to_agent"],"title":"DelegationAddRequest"},"DelegationChainRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"root_agent":{"type":"string","title":"Root Agent"},"root_trust":{"type":"number","title":"Root Trust","default":0.963},"workflow_id":{"type":"string","title":"Workflow Id","default":""}},"type":"object","required":["chain_id","root_agent"],"title":"DelegationChainRequest"},"DependencyFreshnessRequest":{"properties":{"dependency_id":{"type":"string","title":"Dependency Id"},"agent_id":{"type":"string","title":"Agent Id"},"provider":{"type":"string","title":"Provider","default":"AWS"},"last_verified_at":{"type":"string","title":"Last Verified At"},"max_staleness_h":{"type":"number","title":"Max Staleness H","default":24.0}},"type":"object","required":["dependency_id","agent_id","last_verified_at"],"title":"DependencyFreshnessRequest"},"DiagnosticsRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id","default":""},"domain":{"type":"string","title":"Domain","default":"general"},"include_history":{"type":"boolean","title":"Include History","default":false}},"type":"object","title":"DiagnosticsRequest"},"DocumentSnapshotRequest":{"properties":{"document_id":{"type":"string","title":"Document Id"},"agent_id":{"type":"string","title":"Agent Id"},"workflow_id":{"type":"string","title":"Workflow Id"},"content":{"type":"string","title":"Content"},"fields":{"additionalProperties":true,"type":"object","title":"Fields","default":{}},"document_type":{"type":"string","title":"Document Type","default":"general"},"org_id":{"type":"string","title":"Org Id","default":"default"}},"type":"object","required":["document_id","agent_id","workflow_id","content"],"title":"DocumentSnapshotRequest"},"DocumentVerifyRequest":{"properties":{"document_id":{"type":"string","title":"Document Id","default":"doc-001"},"agent_id":{"type":"string","title":"Agent Id","default":"agent-001"},"current_content":{"type":"string","title":"Current Content","default":""},"original_text":{"type":"string","title":"Original Text","default":""},"generated_text":{"type":"string","title":"Generated Text","default":""},"current_text":{"type":"string","title":"Current Text","default":""},"current_fields":{"additionalProperties":true,"type":"object","title":"Current Fields","default":{}},"interaction_num":{"type":"integer","title":"Interaction Num","default":1},"context":{"type":"string","title":"Context","default":"general"},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"}},"type":"object","title":"DocumentVerifyRequest"},"DriftEvaluationRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"domain":{"type":"string","title":"Domain","default":"general"},"evaluation_window_days":{"type":"integer","title":"Evaluation Window Days","default":30},"include_semantic":{"type":"boolean","title":"Include Semantic","default":true},"include_trust":{"type":"boolean","title":"Include Trust","default":true},"include_authority":{"type":"boolean","title":"Include Authority","default":true}},"type":"object","required":["agent_id"],"title":"DriftEvaluationRequest"},"DriftScoreRequest":{"properties":{"document_id":{"type":"string","title":"Document Id","default":"doc-001"},"original_text":{"type":"string","title":"Original Text"},"current_text":{"type":"string","title":"Current Text","default":""},"generated_text":{"type":"string","title":"Generated Text","default":""},"document_type":{"type":"string","title":"Document Type","default":"general"},"interaction_num":{"type":"integer","title":"Interaction Num","default":1}},"type":"object","required":["original_text"],"title":"DriftScoreRequest"},"DrillRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"execution_id":{"type":"string","title":"Execution Id"},"action_type":{"type":"string","title":"Action Type","default":"payment"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"execution_timestamp":{"type":"string","title":"Execution Timestamp","default":""}},"type":"object","required":["agent_id","execution_id"],"title":"DrillRequest"},"DualContextRequest":{"properties":{"atf_receipt_id":{"type":"string","title":"Atf Receipt Id"},"vgs_connector_id":{"type":"string","title":"Vgs Connector Id"},"sac_id":{"type":"string","title":"Sac Id"}},"type":"object","required":["atf_receipt_id","vgs_connector_id","sac_id"],"title":"DualContextRequest"},"EATIssueRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"delegated_by":{"type":"string","title":"Delegated By"},"allowed_action":{"type":"string","title":"Allowed Action"},"allowed_parameters":{"additionalProperties":true,"type":"object","title":"Allowed Parameters","default":{}},"constraints":{"additionalProperties":true,"type":"object","title":"Constraints","default":{}},"validity_hours":{"type":"integer","title":"Validity Hours","default":24},"max_consequence":{"type":"string","title":"Max Consequence","default":"MEDIUM"},"org_id":{"type":"string","title":"Org Id","default":"default"}},"type":"object","required":["agent_id","delegated_by","allowed_action"],"title":"EATIssueRequest"},"EATValidateRequest":{"properties":{"token_id":{"type":"string","title":"Token Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"action_details":{"additionalProperties":true,"type":"object","title":"Action Details","default":{}},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["token_id","agent_id","action_type"],"title":"EATValidateRequest"},"EGMExtendedRequest":{"properties":{"emergency_id":{"type":"string","title":"Emergency Id"},"trigger":{"type":"string","title":"Trigger"},"temporary_authority_expansion":{"additionalProperties":true,"type":"object","title":"Temporary Authority Expansion","default":{}},"consequence_priority_routing":{"additionalProperties":true,"type":"object","title":"Consequence Priority Routing","default":{}},"reconciliation_plan":{"additionalProperties":true,"type":"object","title":"Reconciliation Plan","default":{}}},"type":"object","required":["emergency_id","trigger"],"title":"EGMExtendedRequest"},"ETSRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"UNKNOWN"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"domain":{"type":"string","title":"Domain","default":"general"},"escalation_history":{"type":"integer","title":"Escalation History","default":0},"oversight_confidence":{"type":"number","title":"Oversight Confidence","default":0.85},"temporal_validity":{"type":"boolean","title":"Temporal Validity","default":true},"identity_verified":{"type":"boolean","title":"Identity Verified","default":true},"containment_zone":{"type":"string","title":"Containment Zone","default":""}},"type":"object","required":["agent_id"],"title":"ETSRequest"},"EUAIActAssessRequest":{"properties":{"org_name":{"type":"string","title":"Org Name","default":"My Organisation"},"use_case":{"type":"string","title":"Use Case"},"sector":{"type":"string","title":"Sector","default":"general"},"affects_humans":{"type":"boolean","title":"Affects Humans","default":true},"has_audit_trail":{"type":"boolean","title":"Has Audit Trail","default":false},"has_human_oversight":{"type":"boolean","title":"Has Human Oversight","default":false},"has_risk_assessment":{"type":"boolean","title":"Has Risk Assessment","default":false},"has_technical_docs":{"type":"boolean","title":"Has Technical Docs","default":false},"has_data_governance":{"type":"boolean","title":"Has Data Governance","default":false},"has_monitoring":{"type":"boolean","title":"Has Monitoring","default":false},"annual_revenue_eur":{"type":"number","title":"Annual Revenue Eur","default":0.0},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"additionalProperties":false,"type":"object","required":["use_case"],"title":"EUAIActAssessRequest"},"EUAIActGapRequest":{"properties":{"use_case":{"type":"string","title":"Use Case"},"sector":{"type":"string","title":"Sector","default":"general"},"current_controls":{"items":{},"type":"array","title":"Current Controls","default":[]}},"type":"object","required":["use_case"],"title":"EUAIActGapRequest"},"EmergencyActivateRequest":{"properties":{"incident_id":{"type":"string","title":"Incident Id"},"incident_type":{"type":"string","title":"Incident Type"},"requesting_agent":{"type":"string","title":"Requesting Agent"},"justification":{"type":"string","title":"Justification"},"scope":{"type":"string","title":"Scope","default":"LOCAL"},"duration_minutes":{"type":"integer","title":"Duration Minutes","default":60}},"type":"object","required":["incident_id","incident_type","requesting_agent","justification"],"title":"EmergencyActivateRequest"},"EnterpriseConnectorRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"target_system":{"type":"string","title":"Target System","default":"SAP"},"action_type":{"type":"string","title":"Action Type","default":"data_access"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"}},"type":"object","required":["agent_id"],"title":"EnterpriseConnectorRequest"},"EnterprisePackRequest":{"properties":{"org_id":{"type":"string","title":"Org Id"},"agent_ids":{"items":{},"type":"array","title":"Agent Ids","default":[]},"pack_type":{"type":"string","title":"Pack Type","default":"ALL"},"period_days":{"type":"integer","title":"Period Days","default":30},"include_evidence":{"type":"boolean","title":"Include Evidence","default":true},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"additionalProperties":false,"type":"object","required":["org_id"],"title":"EnterprisePackRequest"},"EnterprisePackResponse":{"properties":{"pack_id":{"type":"string","title":"Pack Id"},"org_id":{"type":"string","title":"Org Id"},"pack_type":{"type":"string","title":"Pack Type"},"generated_at":{"type":"string","title":"Generated At"},"packages":{"additionalProperties":true,"type":"object","title":"Packages"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"},"governance_signature":{"type":"string","title":"Governance Signature"}},"additionalProperties":false,"type":"object","required":["pack_id","org_id","pack_type","generated_at","packages","summary","governance_signature"],"title":"EnterprisePackResponse"},"EscalationIntegrityRequest":{"properties":{"escalation_id":{"type":"string","title":"Escalation Id"},"agent_id":{"type":"string","title":"Agent Id"},"reviewer_id":{"type":"string","title":"Reviewer Id"},"action_type":{"type":"string","title":"Action Type"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"notification_sent":{"type":"boolean","title":"Notification Sent","default":false},"window_seconds":{"type":"integer","title":"Window Seconds","default":3600}},"type":"object","required":["escalation_id","agent_id","reviewer_id","action_type"],"title":"EscalationIntegrityRequest"},"EscalationLegitimacyRequest":{"properties":{"escalation_id":{"type":"string","title":"Escalation Id"},"trigger":{"type":"string","title":"Trigger"},"original_authority":{"type":"string","title":"Original Authority"},"escalated_to":{"type":"string","title":"Escalated To"},"consequence_class":{"type":"string","title":"Consequence Class","default":"HIGH"},"emergency_override":{"type":"boolean","title":"Emergency Override","default":false},"fatigue_check":{"type":"boolean","title":"Fatigue Check","default":true}},"type":"object","required":["escalation_id","trigger","original_authority","escalated_to"],"title":"EscalationLegitimacyRequest"},"EscalationTimeoutRequest":{"properties":{"escalation_id":{"type":"string","title":"Escalation Id"},"agent_id":{"type":"string","title":"Agent Id"},"escalated_at":{"type":"string","title":"Escalated At"},"sla_hours":{"type":"number","title":"Sla Hours","default":48.0},"approver_role":{"type":"string","title":"Approver Role","default":"DPO"}},"type":"object","required":["escalation_id","agent_id","escalated_at"],"title":"EscalationTimeoutRequest"},"EvidenceBundleRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"incident_id":{"type":"string","title":"Incident Id","default":""},"date_from":{"type":"string","title":"Date From","default":""},"date_to":{"type":"string","title":"Date To","default":""},"bundle_type":{"type":"string","title":"Bundle Type","default":"REGULATOR"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"type":"object","required":["agent_id"],"title":"EvidenceBundleRequest"},"EvidenceExportRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"record_ids":{"items":{},"type":"array","title":"Record Ids","default":[]},"export_type":{"type":"string","title":"Export Type","default":"GOVERNANCE_RECEIPT"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"recipient":{"type":"string","title":"Recipient","default":""},"purpose":{"type":"string","title":"Purpose","default":"REGULATORY_AUDIT"}},"type":"object","required":["agent_id"],"title":"EvidenceExportRequest"},"EvidenceLedgerRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"decision":{"type":"string","title":"Decision"},"constitutional_rule":{"type":"string","title":"Constitutional Rule","default":""},"reviewer":{"type":"string","title":"Reviewer","default":""},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}}},"type":"object","required":["agent_id","action_type","decision"],"title":"EvidenceLedgerRequest"},"ExecutionControlRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"amount_usd":{"type":"number","title":"Amount Usd","default":0},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""},"resource":{"type":"string","title":"Resource","default":""}},"type":"object","required":["agent_id","action_type"],"title":"ExecutionControlRequest"},"ExecutionGraphRequest":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"agents":{"items":{},"type":"array","title":"Agents"},"edges":{"items":{},"type":"array","title":"Edges"}},"type":"object","required":["workflow_id","agents","edges"],"title":"ExecutionGraphRequest"},"ExecutionReadinessRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"payment"},"identity_verified":{"type":"boolean","title":"Identity Verified","default":true},"authority_active":{"type":"boolean","title":"Authority Active","default":true},"policy_aligned":{"type":"boolean","title":"Policy Aligned","default":true},"jurisdiction_resolved":{"type":"boolean","title":"Jurisdiction Resolved","default":true},"risk_classified":{"type":"boolean","title":"Risk Classified","default":true},"escalation_resolved":{"type":"boolean","title":"Escalation Resolved","default":true},"human_approved":{"type":"boolean","title":"Human Approved","default":false},"temporal_valid":{"type":"boolean","title":"Temporal Valid","default":true},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"trust_score":{"type":"number","title":"Trust Score","default":0.963}},"type":"object","required":["agent_id"],"title":"ExecutionReadinessRequest"},"ExecutionRecordRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"organization":{"type":"string","title":"Organization","default":""},"authority_chain":{"items":{},"type":"array","title":"Authority Chain","default":[]},"delegation_chain":{"items":{},"type":"array","title":"Delegation Chain","default":[]},"policy_version":{"type":"string","title":"Policy Version","default":"1.0"},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""},"supervisor_id":{"type":"string","title":"Supervisor Id","default":""},"authorization_time":{"type":"string","title":"Authorization Time","default":""},"execution_context":{"additionalProperties":true,"type":"object","title":"Execution Context","default":{}},"consequence_class":{"type":"string","title":"Consequence Class","default":"OPERATIONAL"},"consequence_detail":{"type":"string","title":"Consequence Detail","default":""},"irreversible":{"type":"boolean","title":"Irreversible","default":false},"affected_parties":{"items":{},"type":"array","title":"Affected Parties","default":[]},"financial_impact":{"type":"string","title":"Financial Impact","default":""},"regulatory_domains":{"items":{},"type":"array","title":"Regulatory Domains","default":["GLOBAL"]},"policy_owner":{"type":"string","title":"Policy Owner","default":""},"infrastructure":{"type":"string","title":"Infrastructure","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"execution_start":{"type":"string","title":"Execution Start","default":""},"execution_end":{"type":"string","title":"Execution End","default":""},"workflow_id":{"type":"string","title":"Workflow Id","default":""}},"type":"object","required":["agent_id","action_type"],"title":"ExecutionRecordRequest"},"ExecutionRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"action_details":{"additionalProperties":true,"type":"object","title":"Action Details","default":{}},"resource":{"type":"string","title":"Resource"},"context":{"type":"string","title":"Context","default":"production"}},"type":"object","required":["agent_id","action_type","resource"],"title":"ExecutionRequest"},"FailoverRequest":{"properties":{"primary_mode":{"type":"string","title":"Primary Mode","default":"SUPABASE"},"fallback_mode":{"type":"string","title":"Fallback Mode","default":"IN_MEMORY"},"trigger_condition":{"type":"string","title":"Trigger Condition","default":"DB_UNAVAILABLE"},"auto_failover":{"type":"boolean","title":"Auto Failover","default":true}},"type":"object","title":"FailoverRequest"},"FingerprintRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"action_hash":{"type":"string","title":"Action Hash","default":""},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"type":"object","required":["agent_id","action_type"],"title":"FingerprintRequest"},"FourthPartyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"hyperscaler":{"type":"string","title":"Hyperscaler","default":"AWS"},"ai_service":{"type":"string","title":"Ai Service","default":"SageMaker"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"AU"},"criticality":{"type":"string","title":"Criticality","default":"MATERIAL"}},"type":"object","required":["agent_id"],"title":"FourthPartyRequest"},"FullVerifyRequest":{"properties":{"document_id":{"type":"string","title":"Document Id","default":""},"agent_id":{"type":"string","title":"Agent Id","default":"ai-agent-001"},"original_text":{"type":"string","title":"Original Text","default":""},"current_text":{"type":"string","title":"Current Text","default":""},"document_type":{"type":"string","title":"Document Type","default":"CONTRACT"},"interaction_num":{"type":"integer","title":"Interaction Num","default":1}},"type":"object","title":"FullVerifyRequest"},"GAWIRequest":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"origin_proof":{"type":"string","title":"Origin Proof"},"target_system":{"type":"string","title":"Target System"},"legitimacy_checks":{"additionalProperties":true,"type":"object","title":"Legitimacy Checks","default":{}}},"type":"object","required":["workflow_id","origin_proof","target_system"],"title":"GAWIRequest"},"GCMEvaluationRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"source":{"type":"string","title":"Source","default":"API_A_RUNTIME"},"decision":{"type":"string","title":"Decision","default":"ALLOW"},"evidence_hash":{"type":"string","title":"Evidence Hash","default":""},"reason":{"type":"string","title":"Reason","default":""}},"type":"object","required":["session_id"],"title":"GCMEvaluationRequest"},"GCMFullRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"payment"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"authority_active":{"type":"boolean","title":"Authority Active","default":true},"escalation_resolved":{"type":"boolean","title":"Escalation Resolved","default":true},"jurisdiction_resolved":{"type":"boolean","title":"Jurisdiction Resolved","default":true},"response_content":{"type":"string","title":"Response Content","default":""},"intended_domain":{"type":"string","title":"Intended Domain","default":"OPERATIONAL"},"external_decision":{"type":"string","title":"External Decision","default":"ALLOW"}},"type":"object","required":["agent_id"],"title":"GCMFullRequest"},"GCMSessionRequest":{"properties":{"request_id":{"type":"string","title":"Request Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"payment"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"sources":{"items":{},"type":"array","title":"Sources","default":["API_A_RUNTIME","API_B_RUNTIME","EXTERNAL_WITNESS"]},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"}},"type":"object","required":["request_id","agent_id"],"title":"GCMSessionRequest"},"GOSPolicyRequest":{"properties":{"policy_name":{"type":"string","title":"Policy Name"},"policy_rules":{"additionalProperties":true,"type":"object","title":"Policy Rules","default":{}},"domain":{"type":"string","title":"Domain","default":"general"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"consequence_cap":{"type":"string","title":"Consequence Cap","default":"CRITICAL"}},"type":"object","required":["policy_name"],"title":"GOSPolicyRequest"},"GatewayIssueRequest":{"properties":{"agent_name":{"type":"string","title":"Agent Name"},"owner":{"type":"string","title":"Owner"},"framework":{"type":"string","title":"Framework","default":"generic"},"jurisdiction":{"items":{},"type":"array","title":"Jurisdiction","default":["GLOBAL"]},"org":{"type":"string","title":"Org","default":""}},"type":"object","required":["agent_name","owner"],"title":"GatewayIssueRequest"},"GatewayProveRequest":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"agent_id":{"type":"string","title":"Agent Id","default":""},"formats":{"items":{},"type":"array","title":"Formats","default":["json","pdf"]}},"type":"object","required":["execution_id"],"title":"GatewayProveRequest"},"GatewayRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"origin_jurisdiction":{"type":"string","title":"Origin Jurisdiction","default":"GLOBAL"},"destination_jurisdiction":{"type":"string","title":"Destination Jurisdiction","default":"EU"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"identity_document":{"type":"string","title":"Identity Document","default":""},"visa_id":{"type":"string","title":"Visa Id","default":""},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}}},"type":"object","required":["agent_id","action_type"],"title":"GatewayRequest"},"GatewayVerifyRequest":{"properties":{"passport_id":{"type":"string","title":"Passport Id"},"action":{"additionalProperties":true,"type":"object","title":"Action"},"context":{"additionalProperties":true,"type":"object","title":"Context","default":{}}},"type":"object","required":["passport_id","action"],"title":"GatewayVerifyRequest"},"GenesisRequest":{"properties":{"creator_id":{"type":"string","title":"Creator Id"},"creator_org":{"type":"string","title":"Creator Org"},"agent_name":{"type":"string","title":"Agent Name"},"agent_purpose":{"type":"string","title":"Agent Purpose"},"sovereign_registry":{"type":"string","title":"Sovereign Registry","default":"VeriSigil Sovereign Registry v1"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"intended_actions":{"items":{},"type":"array","title":"Intended Actions","default":[]},"consequence_class":{"type":"string","title":"Consequence Class","default":"MEDIUM"}},"type":"object","required":["creator_id","creator_org","agent_name","agent_purpose"],"title":"GenesisRequest"},"GenesisRevokeRequest":{"properties":{"genesis_id":{"type":"string","title":"Genesis Id"},"revocation_reason":{"type":"string","title":"Revocation Reason"},"revoking_authority":{"type":"string","title":"Revoking Authority"}},"type":"object","required":["genesis_id","revocation_reason","revoking_authority"],"title":"GenesisRevokeRequest"},"GovLangCompileRequest":{"properties":{"policy_statement":{"type":"string","title":"Policy Statement"},"domain":{"type":"string","title":"Domain","default":"general"},"org_id":{"type":"string","title":"Org Id","default":""},"enforce_via":{"type":"string","title":"Enforce Via","default":"/v1/intercept"}},"additionalProperties":false,"type":"object","required":["policy_statement"],"title":"GovLangCompileRequest"},"GovLangEnforceRequest":{"properties":{"policy_id":{"type":"string","title":"Policy Id"},"action_type":{"type":"string","title":"Action Type"},"context":{"additionalProperties":true,"type":"object","title":"Context","default":{}}},"additionalProperties":false,"type":"object","required":["policy_id","action_type"],"title":"GovLangEnforceRequest"},"GovLangPolicyRequest":{"properties":{"policy_name":{"type":"string","title":"Policy Name"},"statements":{"items":{"type":"string"},"type":"array","title":"Statements"},"domain":{"type":"string","title":"Domain","default":"general"},"org_id":{"type":"string","title":"Org Id","default":""},"active":{"type":"boolean","title":"Active","default":true}},"additionalProperties":false,"type":"object","required":["policy_name","statements"],"title":"GovLangPolicyRequest"},"GovernanceConnectorRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"payment"},"target_system":{"type":"string","title":"Target System","default":"PAYMENT"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""},"authority_valid_from":{"type":"string","title":"Authority Valid From","default":""},"authority_valid_until":{"type":"string","title":"Authority Valid Until","default":""},"policy_id":{"type":"string","title":"Policy Id","default":"POL-001"},"genesis_id":{"type":"string","title":"Genesis Id","default":""}},"type":"object","required":["agent_id"],"title":"GovernanceConnectorRequest"},"GovernanceEconomicsRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"approval_latency_ms":{"type":"integer","title":"Approval Latency Ms","default":0},"review_count":{"type":"integer","title":"Review Count","default":1},"escalation_count":{"type":"integer","title":"Escalation Count","default":0},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"domain":{"type":"string","title":"Domain","default":"general"},"execution_blocked":{"type":"boolean","title":"Execution Blocked","default":false}},"type":"object","required":["agent_id","action_type"],"title":"GovernanceEconomicsRequest"},"GovernanceLearningRequest":{"properties":{"override_events":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Override Events","default":[]},"policy_id":{"type":"string","title":"Policy Id","default":""},"auto_apply":{"type":"boolean","title":"Auto Apply","default":false}},"type":"object","title":"GovernanceLearningRequest"},"GovernanceVisaRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"operation_type":{"type":"string","title":"Operation Type"},"source_jurisdiction":{"type":"string","title":"Source Jurisdiction"},"target_jurisdiction":{"type":"string","title":"Target Jurisdiction"},"evidence_bundle_id":{"type":"string","title":"Evidence Bundle Id","default":""},"duration_days":{"type":"integer","title":"Duration Days","default":90},"org_name":{"type":"string","title":"Org Name","default":""}},"additionalProperties":false,"type":"object","required":["agent_id","operation_type","source_jurisdiction","target_jurisdiction"],"title":"GovernanceVisaRequest","description":"Request a governance visa for a specific cross-border operation."},"GoverningForgettingRequest":{"properties":{"mem_id":{"type":"string","title":"Mem Id"},"forgetting_type":{"type":"string","title":"Forgetting Type","default":"EXPIRE"},"reason":{"type":"string","title":"Reason"},"authority":{"type":"string","title":"Authority"}},"type":"object","required":["mem_id","reason","authority"],"title":"GoverningForgettingRequest"},"GraphCollapseRequest":{"properties":{"graph_id":{"type":"string","title":"Graph Id"},"collapse_reason":{"type":"string","title":"Collapse Reason"},"authority_removed":{"type":"boolean","title":"Authority Removed","default":true},"jurisdiction_invalid":{"type":"boolean","title":"Jurisdiction Invalid","default":false},"escalation_timeout":{"type":"boolean","title":"Escalation Timeout","default":false}},"type":"object","required":["graph_id","collapse_reason"],"title":"GraphCollapseRequest"},"HALCheckRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"domain":{"type":"string","title":"Domain","default":"general"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}}},"type":"object","required":["agent_id","action_type"],"title":"HALCheckRequest"},"HALRegisterRequest":{"properties":{"domain":{"type":"string","title":"Domain"},"organization":{"type":"string","title":"Organization","default":""},"custom_rules":{"additionalProperties":true,"type":"object","title":"Custom Rules","default":{}},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"override_level":{"type":"string","title":"Override Level","default":"SENIOR_MANAGER"}},"type":"object","required":["domain"],"title":"HALRegisterRequest"},"HAPLMetricsRequest":{"properties":{"reviewer_id":{"type":"string","title":"Reviewer Id"},"agent_id":{"type":"string","title":"Agent Id","default":""},"escalation_count":{"type":"integer","title":"Escalation Count","default":0},"approval_time_ms":{"type":"integer","title":"Approval Time Ms","default":0},"rejection_rate":{"type":"number","title":"Rejection Rate","default":0.0},"consecutive_approvals":{"type":"integer","title":"Consecutive Approvals","default":0},"time_since_last_break_m":{"type":"integer","title":"Time Since Last Break M","default":0},"review_queue_depth":{"type":"integer","title":"Review Queue Depth","default":0}},"type":"object","required":["reviewer_id"],"title":"HAPLMetricsRequest"},"HSEAEnforceRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"consequence_class":{"type":"string","title":"Consequence Class","default":"CRITICAL"},"human_reviewer_id":{"type":"string","title":"Human Reviewer Id","default":""},"authority_level":{"type":"string","title":"Authority Level","default":"OBSERVE"}},"type":"object","required":["agent_id","action_type"],"title":"HSEAEnforceRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HumanAuthorityContinuityRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"human_id":{"type":"string","title":"Human Id"},"authority_granted_at":{"type":"string","title":"Authority Granted At","default":""},"current_action":{"type":"string","title":"Current Action","default":""},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"},"state_transitions":{"items":{},"type":"array","title":"State Transitions","default":[]},"decisions_made":{"type":"integer","title":"Decisions Made","default":0},"time_elapsed_minutes":{"type":"integer","title":"Time Elapsed Minutes","default":0}},"type":"object","required":["agent_id","human_id"],"title":"HumanAuthorityContinuityRequest"},"HumanAuthorityLevelRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"consequence_class":{"type":"string","title":"Consequence Class","default":"MEDIUM"},"reviewer_id":{"type":"string","title":"Reviewer Id","default":""}},"type":"object","required":["agent_id","action_type"],"title":"HumanAuthorityLevelRequest"},"ISDAIRERequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""},"amount_usd":{"type":"number","title":"Amount Usd","default":0}},"type":"object","required":["agent_id","action_type"],"title":"ISDAIRERequest"},"ImmuneRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"trigger":{"type":"string","title":"Trigger"},"severity":{"type":"string","title":"Severity","default":"HIGH"},"domain":{"type":"string","title":"Domain","default":"general"},"auto_remediate":{"type":"boolean","title":"Auto Remediate","default":true}},"type":"object","required":["agent_id","trigger"],"title":"ImmuneRequest"},"ImpossibilityCertRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"proof_id":{"type":"string","title":"Proof Id"}},"type":"object","required":["agent_id","action_type","proof_id"],"title":"ImpossibilityCertRequest"},"ImpossibilityProofRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"payment"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"authority_valid":{"type":"boolean","title":"Authority Valid","default":true},"escalation_resolved":{"type":"boolean","title":"Escalation Resolved","default":true},"jurisdiction_valid":{"type":"boolean","title":"Jurisdiction Valid","default":true},"consequence":{"type":"string","title":"Consequence","default":"HIGH"}},"type":"object","required":["agent_id"],"title":"ImpossibilityProofRequest"},"IncidentRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"incident_type":{"type":"string","title":"Incident Type"},"severity":{"type":"string","title":"Severity","default":"MEDIUM"},"description":{"type":"string","title":"Description"},"affected_persons":{"type":"integer","title":"Affected Persons","default":0},"corrective_action":{"type":"string","title":"Corrective Action","default":""}},"type":"object","required":["agent_id","incident_type","description"],"title":"IncidentRequest"},"InferenceVerifyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"model_id":{"type":"string","title":"Model Id","default":""},"output_text":{"type":"string","title":"Output Text"},"input_text":{"type":"string","title":"Input Text","default":""},"action_type":{"type":"string","title":"Action Type","default":"INFERENCE"},"domain":{"type":"string","title":"Domain","default":"general"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"expected_topics":{"items":{},"type":"array","title":"Expected Topics","default":[]},"baseline_output":{"type":"string","title":"Baseline Output","default":""}},"type":"object","required":["agent_id","output_text"],"title":"InferenceVerifyRequest"},"IntentAlignmentRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"declared_mandate":{"type":"string","title":"Declared Mandate","default":""},"current_state_hash":{"type":"string","title":"Current State Hash","default":""},"proposed_action":{"type":"string","title":"Proposed Action","default":""},"authority_scope":{"items":{},"type":"array","title":"Authority Scope","default":[]},"consequence_tier":{"type":"string","title":"Consequence Tier","default":"OPERATIONAL"},"workflow_id":{"type":"string","title":"Workflow Id","default":""},"chain_id":{"type":"string","title":"Chain Id","default":""},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"additionalProperties":false,"type":"object","required":["agent_id","action_type"],"title":"IntentAlignmentRequest"},"IntentAlignmentResponse":{"properties":{"verdict":{"type":"string","title":"Verdict"},"mandate_consistent":{"type":"boolean","title":"Mandate Consistent"},"state_coherent":{"type":"boolean","title":"State Coherent"},"scope_aligned":{"type":"boolean","title":"Scope Aligned"},"deviation_detected":{"type":"boolean","title":"Deviation Detected"},"confidence":{"type":"number","title":"Confidence"},"reason":{"type":"string","title":"Reason"},"recommended_action":{"type":"string","title":"Recommended Action"},"governance_signature":{"type":"string","title":"Governance Signature"},"timestamp":{"type":"string","title":"Timestamp"},"intent_review_id":{"type":"string","title":"Intent Review Id"}},"additionalProperties":false,"type":"object","required":["verdict","mandate_consistent","state_coherent","scope_aligned","deviation_detected","confidence","reason","recommended_action","governance_signature","timestamp","intent_review_id"],"title":"IntentAlignmentResponse"},"IntentBindRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"declared_intent":{"type":"string","title":"Declared Intent"},"action_type":{"type":"string","title":"Action Type"},"action_details":{"additionalProperties":true,"type":"object","title":"Action Details","default":{}},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["agent_id","declared_intent","action_type"],"title":"IntentBindRequest"},"IntentCorruptionRequest":{"properties":{"document_id":{"type":"string","title":"Document Id","default":"doc-001"},"original_text":{"type":"string","title":"Original Text"},"current_text":{"type":"string","title":"Current Text","default":""},"generated_text":{"type":"string","title":"Generated Text","default":""},"domain":{"type":"string","title":"Domain","default":"governance"},"agent_id":{"type":"string","title":"Agent Id","default":"agent-001"}},"type":"object","required":["original_text"],"title":"IntentCorruptionRequest"},"InterceptRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"payload_hash":{"type":"string","title":"Payload Hash","default":""},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"authority_scope":{"items":{},"type":"array","title":"Authority Scope","default":[]},"tools_requested":{"items":{},"type":"array","title":"Tools Requested","default":[]},"external_systems":{"items":{},"type":"array","title":"External Systems","default":[]},"irreversible":{"type":"boolean","title":"Irreversible","default":false},"human_present":{"type":"boolean","title":"Human Present","default":false},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"workflow_id":{"type":"string","title":"Workflow Id","default":""},"workflow_step":{"type":"integer","title":"Workflow Step","default":1},"idempotency_key":{"type":"string","title":"Idempotency Key","default":""}},"additionalProperties":false,"type":"object","required":["agent_id","action_type"],"title":"InterceptRequest","description":"Pre-execution interception request.\nCalled BEFORE any consequential AI action executes.\nReturns ALLOW / DENY / ESCALATE in <100ms."},"InvariantCheckRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence","default":{}},"context":{"additionalProperties":true,"type":"object","title":"Context","default":{}}},"type":"object","required":["agent_id","action_type"],"title":"InvariantCheckRequest"},"JurisdictionRequest":{"properties":{"action_type":{"type":"string","title":"Action Type"},"data_subject_region":{"type":"string","title":"Data Subject Region","default":""},"infrastructure_region":{"type":"string","title":"Infrastructure Region","default":""},"agent_owner_jurisdiction":{"type":"string","title":"Agent Owner Jurisdiction","default":""},"amount_usd":{"type":"number","title":"Amount Usd","default":0},"sector":{"type":"string","title":"Sector","default":""},"agent_id":{"type":"string","title":"Agent Id","default":""}},"type":"object","required":["action_type"],"title":"JurisdictionRequest"},"LegitimacyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"domain":{"type":"string","title":"Domain","default":"general"},"ai_role":{"type":"string","title":"Ai Role","default":"RECOMMEND"},"human_authorized":{"type":"boolean","title":"Human Authorized","default":false},"authorization_id":{"type":"string","title":"Authorization Id","default":""},"organization":{"type":"string","title":"Organization","default":""},"custom_rules":{"additionalProperties":true,"type":"object","title":"Custom Rules","default":{}},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"override_level":{"type":"string","title":"Override Level","default":"SENIOR_MANAGER"}},"type":"object","required":["agent_id","action_type"],"title":"LegitimacyRequest"},"LitigationRequest":{"properties":{"org_name":{"type":"string","title":"Org Name"},"case_reference":{"type":"string","title":"Case Reference","default":""},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"decision":{"type":"string","title":"Decision"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"incident_date":{"type":"string","title":"Incident Date","default":""},"evidence_bundles":{"items":{},"type":"array","title":"Evidence Bundles","default":[]},"requesting_party":{"type":"string","title":"Requesting Party","default":""},"legal_counsel":{"type":"string","title":"Legal Counsel","default":""}},"type":"object","required":["org_name","agent_id","action_type","decision"],"title":"LitigationRequest"},"MemoryClassifyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"content_type":{"type":"string","title":"Content Type"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"agent_role":{"type":"string","title":"Agent Role","default":"AUTONOMOUS_AGENT"},"content_topic":{"type":"string","title":"Content Topic","default":""},"data_subjects":{"items":{},"type":"array","title":"Data Subjects","default":[]}},"type":"object","required":["agent_id","content_type"],"title":"MemoryClassifyRequest"},"MemoryIdentityRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"content_type":{"type":"string","title":"Content Type"},"origin_agent_id":{"type":"string","title":"Origin Agent Id"},"authority_source":{"type":"string","title":"Authority Source"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"isolation_zone":{"type":"string","title":"Isolation Zone","default":"OPERATIONAL"},"confidence":{"type":"number","title":"Confidence","default":1.0}},"type":"object","required":["agent_id","content_type","origin_agent_id","authority_source"],"title":"MemoryIdentityRequest"},"MemoryLegitimacyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"memory_entries":{"items":{},"type":"array","title":"Memory Entries","default":[]},"memory_source":{"type":"string","title":"Memory Source","default":""},"retention_policy":{"type":"string","title":"Retention Policy","default":"SESSION"},"cross_session":{"type":"boolean","title":"Cross Session","default":false}},"type":"object","required":["agent_id"],"title":"MemoryLegitimacyRequest"},"MemoryReplayRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"at_timestamp":{"type":"string","title":"At Timestamp"}},"type":"object","required":["agent_id","at_timestamp"],"title":"MemoryReplayRequest"},"MemoryRevokeRequest":{"properties":{"memory_id":{"type":"string","title":"Memory Id"},"revocation_reason":{"type":"string","title":"Revocation Reason"},"revoked_by":{"type":"string","title":"Revoked By"}},"type":"object","required":["memory_id","revocation_reason","revoked_by"],"title":"MemoryRevokeRequest"},"MeshCoordinationRequest":{"properties":{"initiating_org":{"type":"string","title":"Initiating Org"},"participating_orgs":{"items":{},"type":"array","title":"Participating Orgs","default":[]},"coordination_type":{"type":"string","title":"Coordination Type","default":"GOVERNANCE_ALIGNMENT"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}}},"type":"object","required":["initiating_org"],"title":"MeshCoordinationRequest"},"ModelClassRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"model_class":{"type":"string","title":"Model Class"},"model_version":{"type":"string","title":"Model Version","default":""},"organization":{"type":"string","title":"Organization","default":""},"purpose":{"type":"string","title":"Purpose","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"}},"type":"object","required":["agent_id","model_class"],"title":"ModelClassRequest"},"NodeProfileRequest":{"properties":{"node_name":{"type":"string","title":"Node Name"},"deployment_type":{"type":"string","title":"Deployment Type","default":"CLOUD"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"organization":{"type":"string","title":"Organization","default":""},"capabilities":{"items":{},"type":"array","title":"Capabilities","default":[]},"sovereignty_mode":{"type":"boolean","title":"Sovereignty Mode","default":false}},"type":"object","required":["node_name"],"title":"NodeProfileRequest"},"NonconformityRequest":{"properties":{"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"detected_by":{"type":"string","title":"Detected By","default":"SYSTEM"},"severity":{"type":"string","title":"Severity","default":"MAJOR"},"constitutional_violation":{"type":"string","title":"Constitutional Violation","default":""},"agent_id":{"type":"string","title":"Agent Id","default":""},"evidence_ref":{"type":"string","title":"Evidence Ref","default":""}},"type":"object","required":["title","description"],"title":"NonconformityRequest"},"NumericalRequest":{"properties":{"document_id":{"type":"string","title":"Document Id","default":"doc-001"},"original_text":{"type":"string","title":"Original Text"},"current_text":{"type":"string","title":"Current Text","default":""},"generated_text":{"type":"string","title":"Generated Text","default":""},"currency":{"type":"string","title":"Currency","default":"USD"},"agent_id":{"type":"string","title":"Agent Id","default":"agent-001"}},"type":"object","required":["original_text"],"title":"NumericalRequest"},"OATMRequest":{"properties":{"ecosystem_id":{"type":"string","title":"Ecosystem Id"},"authority_nodes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Authority Nodes","default":[]},"delegation_rules":{"additionalProperties":true,"type":"object","title":"Delegation Rules","default":{}},"topology_hash":{"type":"string","title":"Topology Hash","default":""}},"type":"object","required":["ecosystem_id"],"title":"OATMRequest"},"OverrideReceiptRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount"},"consequence_class":{"type":"string","title":"Consequence Class","default":"CRITICAL"},"reviewer_did":{"type":"string","title":"Reviewer Did"},"competency_claims":{"items":{"type":"string"},"type":"array","title":"Competency Claims","default":[]},"authority_scope":{"items":{"type":"string"},"type":"array","title":"Authority Scope","default":[]},"decision":{"type":"string","title":"Decision"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["agent_id","action_type","reviewer_did","decision","reason"],"title":"OverrideReceiptRequest"},"OversightRecordRequest":{"properties":{"reviewer_id":{"type":"string","title":"Reviewer Id"},"agent_id":{"type":"string","title":"Agent Id"},"decision":{"type":"string","title":"Decision"},"review_time_ms":{"type":"integer","title":"Review Time Ms","default":0},"reviewed_items":{"type":"integer","title":"Reviewed Items","default":1},"auto_approved":{"type":"boolean","title":"Auto Approved","default":false},"domain":{"type":"string","title":"Domain","default":"general"}},"type":"object","required":["reviewer_id","agent_id","decision"],"title":"OversightRecordRequest"},"PDFReportRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"institution":{"type":"string","title":"Institution"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"period":{"type":"string","title":"Period","default":"2026-Q2"}},"type":"object","required":["agent_id","institution"],"title":"PDFReportRequest"},"PathProofRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"payment"},"authority_state":{"type":"string","title":"Authority State","default":"VALID"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"escalation_state":{"type":"string","title":"Escalation State","default":"RESOLVED"},"jurisdiction_state":{"type":"string","title":"Jurisdiction State","default":"RESOLVED"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"}},"type":"object","required":["agent_id"],"title":"PathProofRequest"},"PathologyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"domain":{"type":"string","title":"Domain","default":"general"},"affected_parties":{"type":"integer","title":"Affected Parties","default":1},"financial_impact":{"type":"number","title":"Financial Impact","default":0.0},"chain_depth":{"type":"integer","title":"Chain Depth","default":3},"authority_conflicts":{"type":"integer","title":"Authority Conflicts","default":0}},"type":"object","required":["agent_id","action_type"],"title":"PathologyRequest"},"PilotRequest":{"properties":{"organization":{"type":"string","title":"Organization"},"contact_name":{"type":"string","title":"Contact Name"},"contact_email":{"type":"string","title":"Contact Email"},"ai_framework":{"type":"string","title":"Ai Framework","default":"langchain"},"agent_count":{"type":"integer","title":"Agent Count","default":5},"use_case":{"type":"string","title":"Use Case","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"type":"object","required":["organization","contact_name","contact_email"],"title":"PilotRequest"},"PogcStoreRequest":{"properties":{"pogc_json":{"type":"string","title":"Pogc Json"},"verify":{"type":"boolean","title":"Verify","default":true}},"type":"object","required":["pogc_json"],"title":"PogcStoreRequest"},"PogcVerifyRequest":{"properties":{"pogc_id":{"type":"string","title":"Pogc Id","default":""},"content_hash":{"type":"string","title":"Content Hash","default":""},"evidence_hash":{"type":"string","title":"Evidence Hash","default":""}},"type":"object","title":"PogcVerifyRequest"},"PolicyCompileRequest":{"properties":{"source_text":{"type":"string","title":"Source Text"},"source_framework":{"type":"string","title":"Source Framework","default":"CUSTOM"},"target_domain":{"type":"string","title":"Target Domain","default":"general"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"strictness":{"type":"string","title":"Strictness","default":"HIGH"}},"type":"object","required":["source_text"],"title":"PolicyCompileRequest"},"PolicyDriftRequest":{"properties":{"current_policy_hash":{"type":"string","title":"Current Policy Hash"},"baseline_policy_hash":{"type":"string","title":"Baseline Policy Hash"},"policy_id":{"type":"string","title":"Policy Id","default":"POL-001"},"last_changed_at":{"type":"string","title":"Last Changed At"}},"type":"object","required":["current_policy_hash","baseline_policy_hash","last_changed_at"],"title":"PolicyDriftRequest"},"PortableEvidenceRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"decision":{"type":"string","title":"Decision"},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}},"human_approved":{"type":"boolean","title":"Human Approved","default":false},"approver_id":{"type":"string","title":"Approver Id","default":""}},"type":"object","required":["agent_id","action_type","decision"],"title":"PortableEvidenceRequest"},"PreventionVerifyRequest":{"properties":{"nc_id":{"type":"string","title":"Nc Id"},"ca_id":{"type":"string","title":"Ca Id"},"verification_evidence":{"type":"string","title":"Verification Evidence","default":""},"verified_by":{"type":"string","title":"Verified By","default":""}},"type":"object","required":["nc_id","ca_id"],"title":"PreventionVerifyRequest"},"ProgressionRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"workflow_id":{"type":"string","title":"Workflow Id"},"current_step":{"type":"integer","title":"Current Step","default":1},"total_steps":{"type":"integer","title":"Total Steps","default":1},"previous_steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Previous Steps","default":[]},"intended_action":{"type":"string","title":"Intended Action"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence","default":{}},"consequence_level":{"type":"string","title":"Consequence Level","default":"MEDIUM"},"org_id":{"type":"string","title":"Org Id","default":"default"}},"type":"object","required":["agent_id","workflow_id","intended_action"],"title":"ProgressionRequest"},"ProvisionKeyRequest":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"plan":{"type":"string","title":"Plan","default":"STARTER"},"email":{"type":"string","title":"Email","default":""}},"type":"object","required":["tenant_id"],"title":"ProvisionKeyRequest"},"PublicScanRequest":{"properties":{"agent_config_raw":{"type":"string","title":"Agent Config Raw"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},"type":"object","required":["agent_config_raw"],"title":"PublicScanRequest"},"RCRSurvBridgeRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"agent_id":{"type":"string","title":"Agent Id"},"survivability_score":{"type":"number","title":"Survivability Score","default":0.85},"rollback_score":{"type":"number","title":"Rollback Score","default":0.75},"policy_version":{"type":"string","title":"Policy Version","default":"POL-001-v1.0"},"escalation_decay":{"type":"number","title":"Escalation Decay","default":0.1},"commitment_count":{"type":"integer","title":"Commitment Count","default":0}},"type":"object","required":["chain_id","agent_id"],"title":"RCRSurvBridgeRequest"},"RELRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type","default":"api_call"},"interception_point":{"type":"string","title":"Interception Point","default":"API_CALL"},"command_or_target":{"type":"string","title":"Command Or Target","default":""},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"authority_active":{"type":"boolean","title":"Authority Active","default":true},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"type":"object","required":["agent_id"],"title":"RELRequest"},"RegisterVerifierReq":{"properties":{"name":{"type":"string","title":"Name"},"email":{"type":"string","title":"Email"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":"developer"}},"type":"object","required":["name","email"],"title":"RegisterVerifierReq"},"RegulatorPackageRequest":{"properties":{"agent_did":{"type":"string","title":"Agent Did"},"regulator":{"type":"string","title":"Regulator","default":"EU AI Office"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"period":{"type":"string","title":"Period","default":"2026-Q2"}},"type":"object","required":["agent_did"],"title":"RegulatorPackageRequest"},"RelianceLiabilityRequest":{"properties":{"governance_proof_id":{"type":"string","title":"Governance Proof Id"},"relying_party":{"type":"string","title":"Relying Party"},"relying_domain":{"type":"string","title":"Relying Domain"},"relying_jurisdiction":{"type":"string","title":"Relying Jurisdiction","default":"EU"},"liability_model":{"type":"string","title":"Liability Model","default":"STRICT"},"consequence_if_wrong":{"type":"string","title":"Consequence If Wrong","default":"HIGH"},"proof_origin_domain":{"type":"string","title":"Proof Origin Domain","default":""},"proof_origin_system":{"type":"string","title":"Proof Origin System","default":""}},"type":"object","required":["governance_proof_id","relying_party","relying_domain"],"title":"RelianceLiabilityRequest"},"RelianceResolveRequest":{"properties":{"origin_proof_id":{"type":"string","title":"Origin Proof Id"},"origin_evidence_hash":{"type":"string","title":"Origin Evidence Hash"},"receiving_domain":{"type":"string","title":"Receiving Domain"},"receiving_jurisdiction":{"type":"string","title":"Receiving Jurisdiction","default":"EU"},"local_policy_ref":{"type":"string","title":"Local Policy Ref","default":""},"consequence_class":{"type":"string","title":"Consequence Class","default":"CRITICAL"}},"type":"object","required":["origin_proof_id","origin_evidence_hash","receiving_domain"],"title":"RelianceResolveRequest"},"ReplayRequest":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"authority_valid_from":{"type":"string","title":"Authority Valid From","default":""},"authority_valid_until":{"type":"string","title":"Authority Valid Until","default":""},"execution_timestamp":{"type":"string","title":"Execution Timestamp","default":""},"amount_usd":{"type":"number","title":"Amount Usd","default":0},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""}},"type":"object","required":["execution_id","agent_id","action_type"],"title":"ReplayRequest"},"ReviewScheduleRequest":{"properties":{"scope_id":{"type":"string","title":"Scope Id"},"review_type":{"type":"string","title":"Review Type","default":"PERIODIC"},"frequency_days":{"type":"integer","title":"Frequency Days","default":90},"responsible_party":{"type":"string","title":"Responsible Party","default":""},"next_review_date":{"type":"string","title":"Next Review Date","default":""}},"type":"object","required":["scope_id"],"title":"ReviewScheduleRequest"},"RevocationRequest":{"properties":{"chain_id":{"type":"string","title":"Chain Id"},"agent_id":{"type":"string","title":"Agent Id"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["chain_id","agent_id","reason"],"title":"RevocationRequest"},"RevokeReq":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"reason":{"type":"string","title":"Reason","default":"manual_revocation"}},"type":"object","required":["agent_id"],"title":"RevokeReq"},"RiskAssessmentRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"system_name":{"type":"string","title":"System Name"},"autonomy_level":{"type":"string","title":"Autonomy Level","default":"FULL"},"execution_authority":{"type":"string","title":"Execution Authority","default":"MEDIUM"},"human_override_score":{"type":"number","title":"Human Override Score","default":0.8},"societal_impact_class":{"type":"string","title":"Societal Impact Class","default":"MEDIUM"},"constitutional_risk":{"type":"string","title":"Constitutional Risk","default":"MEDIUM"},"admissibility_confidence":{"type":"number","title":"Admissibility Confidence","default":0.85},"evidence_survivability":{"type":"number","title":"Evidence Survivability","default":0.9},"escalation_required":{"type":"boolean","title":"Escalation Required","default":false},"domain":{"type":"string","title":"Domain","default":"general"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"}},"type":"object","required":["agent_id","system_name"],"title":"RiskAssessmentRequest"},"RiskEngineRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"domain":{"type":"string","title":"Domain","default":"general"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"financial_impact":{"type":"number","title":"Financial Impact","default":0.0},"affected_parties":{"type":"integer","title":"Affected Parties","default":1},"reversible":{"type":"boolean","title":"Reversible","default":true},"escalation_count":{"type":"integer","title":"Escalation Count","default":0},"shadow_risk":{"type":"string","title":"Shadow Risk","default":"LOW"},"time_sensitive":{"type":"boolean","title":"Time Sensitive","default":false}},"type":"object","required":["agent_id","action_type"],"title":"RiskEngineRequest"},"SIEMEventRequest":{"properties":{"event_type":{"type":"string","title":"Event Type"},"agent_id":{"type":"string","title":"Agent Id"},"decision":{"type":"string","title":"Decision","default":"ALLOW"},"evidence_id":{"type":"string","title":"Evidence Id","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"severity":{"type":"string","title":"Severity","default":"INFO"},"siem_target":{"type":"string","title":"Siem Target","default":"SPLUNK"}},"type":"object","required":["event_type","agent_id"],"title":"SIEMEventRequest"},"ScanReq":{"properties":{"code":{"type":"string","title":"Code"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},"type":"object","required":["code"],"title":"ScanReq"},"ScopeRegisterRequest":{"properties":{"scope_name":{"type":"string","title":"Scope Name"},"organization":{"type":"string","title":"Organization"},"governed_systems":{"items":{},"type":"array","title":"Governed Systems","default":[]},"excluded_systems":{"items":{},"type":"array","title":"Excluded Systems","default":[]},"exclusion_reasons":{"additionalProperties":true,"type":"object","title":"Exclusion Reasons","default":{}},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"effective_date":{"type":"string","title":"Effective Date","default":""},"review_date":{"type":"string","title":"Review Date","default":""},"responsible_party":{"type":"string","title":"Responsible Party","default":""}},"type":"object","required":["scope_name","organization"],"title":"ScopeRegisterRequest"},"SemanticAlignmentRequest":{"properties":{"runtime_a":{"type":"string","title":"Runtime A","default":"ATF-L2-OMNIX"},"runtime_b":{"type":"string","title":"Runtime B","default":"VGS-RUNTIME-VERISIGIL"},"term_alignments":{"additionalProperties":true,"type":"object","title":"Term Alignments","default":{}}},"type":"object","title":"SemanticAlignmentRequest"},"SemanticChainRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"chain_outputs":{"items":{},"type":"array","title":"Chain Outputs"},"original_intent":{"type":"string","title":"Original Intent","default":""},"domain":{"type":"string","title":"Domain","default":"general"},"workflow_id":{"type":"string","title":"Workflow Id","default":""}},"type":"object","required":["agent_id","chain_outputs"],"title":"SemanticChainRequest"},"ShadowDetectionRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_did":{"type":"string","title":"Agent Did"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"action_type":{"type":"string","title":"Action Type","default":"payment"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""},"execution_context":{"type":"string","title":"Execution Context","default":""}},"type":"object","required":["agent_id","agent_did"],"title":"ShadowDetectionRequest"},"SigilGuardEvent":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"module":{"type":"string","title":"Module"},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity","default":"medium"},"event_type":{"type":"string","title":"Event Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"score_before":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score Before"},"score_after":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score After"},"remediation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remediation"},"remediated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remediated","default":false},"remediation_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Remediation Ms"},"raw_payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Raw Payload","default":{}}},"type":"object","required":["agent_id","module","event_type"],"title":"SigilGuardEvent"},"SovereignBridgeRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"source_jurisdiction":{"type":"string","title":"Source Jurisdiction","default":"EU"},"target_jurisdiction":{"type":"string","title":"Target Jurisdiction","default":"US"},"use_case":{"type":"string","title":"Use Case","default":""},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"},"controls_in_source":{"items":{},"type":"array","title":"Controls In Source","default":[]},"org_name":{"type":"string","title":"Org Name","default":""}},"additionalProperties":false,"type":"object","required":["agent_id","action_type"],"title":"SovereignBridgeRequest","description":"Cross-jurisdictional governance translation request.\nGenerates a 'governance visa' for cross-border AI deployment."},"SovereignDiagRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"provider":{"type":"string","title":"Provider","default":""},"external_calls":{"type":"integer","title":"External Calls","default":0},"telemetry_events":{"type":"integer","title":"Telemetry Events","default":0},"foreign_models":{"items":{},"type":"array","title":"Foreign Models","default":[]},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"}},"type":"object","required":["agent_id"],"title":"SovereignDiagRequest"},"SovereignRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"isolation_level":{"type":"string","title":"Isolation Level","default":"STANDARD"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"allowed_endpoints":{"items":{},"type":"array","title":"Allowed Endpoints","default":[]},"telemetry_disabled":{"type":"boolean","title":"Telemetry Disabled","default":true}},"type":"object","required":["agent_id"],"title":"SovereignRequest"},"SovereignShutdownRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"coordination_type":{"type":"string","title":"Coordination Type","default":"QUARANTINE"},"reason":{"type":"string","title":"Reason"},"authorized_by":{"type":"string","title":"Authorized By"},"scope":{"type":"string","title":"Scope","default":"AGENT"},"reversible":{"type":"boolean","title":"Reversible","default":true},"evidence_ref":{"type":"string","title":"Evidence Ref","default":""}},"type":"object","required":["agent_id","reason","authorized_by"],"title":"SovereignShutdownRequest"},"SovereigntyBridgeRequest":{"properties":{"bridge_name":{"type":"string","title":"Bridge Name"},"source_runtime":{"type":"string","title":"Source Runtime"},"target_runtime":{"type":"string","title":"Target Runtime"},"source_jurisdiction":{"type":"string","title":"Source Jurisdiction","default":"GLOBAL"},"target_jurisdiction":{"type":"string","title":"Target Jurisdiction","default":"GLOBAL"},"bridge_type":{"type":"string","title":"Bridge Type","default":"ENTERPRISE"},"shared_policies":{"additionalProperties":true,"type":"object","title":"Shared Policies","default":{}},"validity_hours":{"type":"integer","title":"Validity Hours","default":168}},"type":"object","required":["bridge_name","source_runtime","target_runtime"],"title":"SovereigntyBridgeRequest"},"SprintRequest":{"properties":{"customer_name":{"type":"string","title":"Customer Name"},"customer_email":{"type":"string","title":"Customer Email"},"company_name":{"type":"string","title":"Company Name"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"agent_name":{"type":"string","title":"Agent Name"},"agent_description":{"type":"string","title":"Agent Description"},"industry":{"type":"string","title":"Industry"},"framework":{"type":"string","title":"Framework","default":"unknown"},"eu_users":{"type":"boolean","title":"Eu Users","default":true},"linkedin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin"}},"type":"object","required":["customer_name","customer_email","company_name","agent_name","agent_description","industry"],"title":"SprintRequest"},"StackEvaluateRequest":{"properties":{"system_name":{"type":"string","title":"System Name"},"role":{"type":"string","title":"Role"},"operates_at":{"type":"string","title":"Operates At"},"intercepts":{"type":"boolean","title":"Intercepts","default":false},"generates_proof":{"type":"boolean","title":"Generates Proof","default":false},"blocks_action":{"type":"boolean","title":"Blocks Action","default":false}},"type":"object","required":["system_name","role","operates_at"],"title":"StackEvaluateRequest"},"StaleAuthorityRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"authority_valid_until":{"type":"string","title":"Authority Valid Until"},"last_verified_at":{"type":"string","title":"Last Verified At"}},"type":"object","required":["agent_id","authority_valid_until","last_verified_at"],"title":"StaleAuthorityRequest"},"StateTransitionRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"from_state":{"type":"string","title":"From State"},"to_state":{"type":"string","title":"To State"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence","default":{}}},"type":"object","required":["agent_id","from_state","to_state"],"title":"StateTransitionRequest"},"StressTestRequest":{"properties":{"scenario":{"type":"string","title":"Scenario","default":"ESCALATION_OVERLOAD"},"intensity":{"type":"number","title":"Intensity","default":0.5},"duration_s":{"type":"integer","title":"Duration S","default":60},"domain":{"type":"string","title":"Domain","default":"general"}},"type":"object","title":"StressTestRequest"},"SurvivabilityRequest":{"properties":{"ves_id":{"type":"string","title":"Ves Id","default":""},"evidence_id":{"type":"string","title":"Evidence Id","default":""},"check_dimensions":{"items":{},"type":"array","title":"Check Dimensions","default":["vendor","system","time","legal","cross_domain"]}},"type":"object","title":"SurvivabilityRequest"},"TARTAPBridgeRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"authority_valid_from":{"type":"string","title":"Authority Valid From","default":""},"authority_valid_until":{"type":"string","title":"Authority Valid Until","default":""},"execution_timestamp":{"type":"string","title":"Execution Timestamp","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"revocation_state":{"type":"string","title":"Revocation State","default":"ACTIVE"},"gcs_at_execution":{"type":"number","title":"Gcs At Execution","default":0.95}},"type":"object","required":["agent_id"],"title":"TARTAPBridgeRequest"},"TemporalAdmissibilityRequest":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"authority_valid_from":{"type":"string","title":"Authority Valid From"},"authority_valid_until":{"type":"string","title":"Authority Valid Until"},"execution_timestamp":{"type":"string","title":"Execution Timestamp"},"eat_token_id":{"type":"string","title":"Eat Token Id","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU_AI_ACT"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["execution_id","agent_id","action_type","authority_valid_from","authority_valid_until","execution_timestamp"],"title":"TemporalAdmissibilityRequest"},"TemporalLegitimacyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"authority_issued_at":{"type":"string","title":"Authority Issued At","default":""},"authority_expires_at":{"type":"string","title":"Authority Expires At","default":""},"context_snapshot_at":{"type":"string","title":"Context Snapshot At","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"policy_version":{"type":"string","title":"Policy Version","default":"1.0"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["agent_id","action_type"],"title":"TemporalLegitimacyRequest"},"TenantRequest":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"org_name":{"type":"string","title":"Org Name"},"plan":{"type":"string","title":"Plan","default":"PROFESSIONAL"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"admin_email":{"type":"string","title":"Admin Email","default":""}},"type":"object","required":["tenant_id","org_name"],"title":"TenantRequest"},"ThreatSignalRequest":{"properties":{"signal_type":{"type":"string","title":"Signal Type"},"agent_id":{"type":"string","title":"Agent Id","default":""},"provider":{"type":"string","title":"Provider","default":""},"severity":{"type":"string","title":"Severity","default":"MEDIUM"},"description":{"type":"string","title":"Description","default":""},"framework_origin":{"type":"string","title":"Framework Origin","default":"VGS"},"affected_count":{"type":"integer","title":"Affected Count","default":1}},"type":"object","required":["signal_type"],"title":"ThreatSignalRequest"},"TimelockExecuteRequest":{"properties":{"timelock_id":{"type":"string","title":"Timelock Id"},"requestor_id":{"type":"string","title":"Requestor Id","default":""},"approvals":{"items":{},"type":"array","title":"Approvals","default":[]}},"additionalProperties":false,"type":"object","required":["timelock_id"],"title":"TimelockExecuteRequest"},"TimelockRequest":{"properties":{"operation_id":{"type":"string","title":"Operation Id"},"operation_type":{"type":"string","title":"Operation Type"},"consequence":{"type":"string","title":"Consequence","default":"OPERATIONAL"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}},"requestor_id":{"type":"string","title":"Requestor Id","default":""},"justification":{"type":"string","title":"Justification","default":""},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"}},"additionalProperties":false,"type":"object","required":["operation_id","operation_type"],"title":"TimelockRequest"},"TopologyEdgeRequest":{"properties":{"from_agent_id":{"type":"string","title":"From Agent Id"},"to_agent_id":{"type":"string","title":"To Agent Id"},"edge_type":{"type":"string","title":"Edge Type","default":"DELEGATES_TO"},"weight":{"type":"number","title":"Weight","default":1.0},"label":{"type":"string","title":"Label","default":""},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"}},"type":"object","required":["from_agent_id","to_agent_id"],"title":"TopologyEdgeRequest"},"TopologyGraphRequest":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"agents":{"items":{},"type":"array","title":"Agents"},"authority_states":{"additionalProperties":true,"type":"object","title":"Authority States","default":{}},"trust_scores":{"additionalProperties":true,"type":"object","title":"Trust Scores","default":{}}},"type":"object","required":["workflow_id","agents"],"title":"TopologyGraphRequest"},"TopologyNodeRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"type":"string","title":"Agent Name"},"agent_role":{"type":"string","title":"Agent Role","default":"EXECUTOR"},"trust_score":{"type":"number","title":"Trust Score","default":0.963},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"owner_org":{"type":"string","title":"Owner Org","default":""},"consequence_class":{"type":"string","title":"Consequence Class","default":"MEDIUM"}},"type":"object","required":["agent_id","agent_name"],"title":"TopologyNodeRequest"},"TranslateRequest":{"properties":{"concept":{"type":"string","title":"Concept"},"audience":{"type":"string","title":"Audience","default":"board"},"context":{"type":"string","title":"Context","default":""}},"type":"object","required":["concept"],"title":"TranslateRequest"},"TrustFederationRequest":{"properties":{"federation_name":{"type":"string","title":"Federation Name"},"members":{"items":{},"type":"array","title":"Members"},"federation_type":{"type":"string","title":"Federation Type","default":"BILATERAL"},"trust_threshold":{"type":"number","title":"Trust Threshold","default":0.8},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"governance_policy":{"additionalProperties":true,"type":"object","title":"Governance Policy","default":{}}},"type":"object","required":["federation_name","members"],"title":"TrustFederationRequest"},"TrustProjectionRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"current_trust":{"type":"number","title":"Current Trust","default":0.963},"trend":{"type":"string","title":"Trend","default":"STABLE"},"escalation_rate":{"type":"number","title":"Escalation Rate","default":0.05},"anomaly_rate":{"type":"number","title":"Anomaly Rate","default":0.02},"projection_days":{"type":"integer","title":"Projection Days","default":30}},"type":"object","required":["agent_id"],"title":"TrustProjectionRequest"},"TrustRevocationRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"reason":{"type":"string","title":"Reason"},"revoked_by":{"type":"string","title":"Revoked By"},"revocation_scope":{"type":"string","title":"Revocation Scope","default":"GOVERNANCE_TRUST"},"evidence_ref":{"type":"string","title":"Evidence Ref","default":""}},"type":"object","required":["agent_id","reason","revoked_by"],"title":"TrustRevocationRequest"},"VSLParseRequest":{"properties":{"script":{"type":"string","title":"Script"},"agent_id":{"type":"string","title":"Agent Id","default":""},"validate_authority":{"type":"boolean","title":"Validate Authority","default":true}},"type":"object","required":["script"],"title":"VSLParseRequest"},"VSLProgram":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"vsl_source":{"type":"string","title":"Vsl Source"},"action_type":{"type":"string","title":"Action Type"},"consequence":{"type":"string","title":"Consequence","default":"MEDIUM"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"type":"object","required":["agent_id","vsl_source","action_type"],"title":"VSLProgram"},"VSLRepairRequest":{"properties":{"execution_id":{"type":"string","title":"Execution Id"},"agent_id":{"type":"string","title":"Agent Id"},"failure_type":{"type":"string","title":"Failure Type","default":"INVALID_STATE"},"current_state":{"additionalProperties":true,"type":"object","title":"Current State","default":{}}},"type":"object","required":["execution_id","agent_id"],"title":"VSLRepairRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VeriVMRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"program":{"type":"string","title":"Program"},"inputs":{"additionalProperties":true,"type":"object","title":"Inputs","default":{}},"execution_mode":{"type":"string","title":"Execution Mode","default":"STRICT"}},"type":"object","required":["agent_id","program"],"title":"VeriVMRequest"},"VerifyRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"action_type":{"type":"string","title":"Action Type"},"action_detail":{"type":"string","title":"Action Detail"},"policy_mode":{"type":"string","title":"Policy Mode","default":"standard"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context","default":{}}},"type":"object","required":["agent_id","action_type","action_detail"],"title":"VerifyRequest"},"VisaRequest":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"issuing_org":{"type":"string","title":"Issuing Org"},"target_domain":{"type":"string","title":"Target Domain"},"permitted_actions":{"items":{},"type":"array","title":"Permitted Actions","default":[]},"validity_hours":{"type":"integer","title":"Validity Hours","default":24},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"max_consequence":{"type":"string","title":"Max Consequence","default":"MEDIUM"}},"type":"object","required":["agent_id","issuing_org","target_domain"],"title":"VisaRequest"},"WaitlistSignup":{"properties":{"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"use_case":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Case"},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier","default":"free"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":"homepage"}},"type":"object","required":["email"],"title":"WaitlistSignup"},"WorkflowCreateRequest":{"properties":{"workflow_name":{"type":"string","title":"Workflow Name"},"action_type":{"type":"string","title":"Action Type"},"agent_id":{"type":"string","title":"Agent Id"},"consequence":{"type":"string","title":"Consequence","default":"HIGH"},"domain":{"type":"string","title":"Domain","default":"general"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"sequence_template":{"type":"string","title":"Sequence Template","default":"custom"},"custom_approvers":{"items":{},"type":"array","title":"Custom Approvers","default":[]},"concurrence_type":{"type":"string","title":"Concurrence Type","default":"ALL"},"concurrence_n":{"type":"integer","title":"Concurrence N","default":1},"concurrence_m":{"type":"integer","title":"Concurrence M","default":1},"window_hours":{"type":"integer","title":"Window Hours","default":24},"financial_amount":{"type":"number","title":"Financial Amount","default":0.0},"emergency_override":{"type":"boolean","title":"Emergency Override","default":false}},"type":"object","required":["workflow_name","action_type","agent_id"],"title":"WorkflowCreateRequest"},"WorkflowReadinessRequest":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"workflow_name":{"type":"string","title":"Workflow Name"},"steps":{"items":{"type":"string"},"type":"array","title":"Steps","default":[]},"agents_involved":{"items":{"type":"string"},"type":"array","title":"Agents Involved","default":[]},"consequence_tier":{"type":"string","title":"Consequence Tier","default":"OPERATIONAL"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"has_escalation":{"type":"boolean","title":"Has Escalation","default":false},"has_human_review":{"type":"boolean","title":"Has Human Review","default":false},"has_audit_trail":{"type":"boolean","title":"Has Audit Trail","default":false}},"type":"object","required":["workflow_id","workflow_name"],"title":"WorkflowReadinessRequest"},"main__BirthCertRequest__1":{"properties":{"creator_id":{"type":"string","title":"Creator Id"},"creator_org":{"type":"string","title":"Creator Org"},"agent_name":{"type":"string","title":"Agent Name"},"agent_purpose":{"type":"string","title":"Agent Purpose"},"model_origin":{"type":"string","title":"Model Origin","default":"unknown"},"training_jurisdiction":{"type":"string","title":"Training Jurisdiction","default":"EU"},"hardware_attested":{"type":"boolean","title":"Hardware Attested","default":false},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"EU"},"risk_classification":{"type":"string","title":"Risk Classification","default":"HIGH_RISK"}},"type":"object","required":["creator_id","creator_org","agent_name","agent_purpose"],"title":"BirthCertRequest"},"main__BirthCertRequest__2":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"creator_id":{"type":"string","title":"Creator Id"},"organization":{"type":"string","title":"Organization"},"jurisdiction":{"type":"string","title":"Jurisdiction","default":"GLOBAL"},"capability_class":{"type":"string","title":"Capability Class","default":"READ_ONLY"},"permitted_domains":{"items":{},"type":"array","title":"Permitted Domains","default":[]},"governance_dna":{"additionalProperties":true,"type":"object","title":"Governance Dna","default":{}},"purpose":{"type":"string","title":"Purpose","default":""}},"type":"object","required":["agent_id","creator_id","organization"],"title":"BirthCertRequest"},"main__CrossDomainRequest__1":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"source_domain":{"type":"string","title":"Source Domain"},"target_domain":{"type":"string","title":"Target Domain"},"transfer_type":{"type":"string","title":"Transfer Type","default":"INFERENCE"},"payload_summary":{"type":"string","title":"Payload Summary","default":""}},"type":"object","required":["agent_id","source_domain","target_domain"],"title":"CrossDomainRequest"},"main__CrossDomainRequest__2":{"properties":{"ves_id":{"type":"string","title":"Ves Id"},"source_domain":{"type":"string","title":"Source Domain"},"target_domain":{"type":"string","title":"Target Domain"},"target_jurisdiction":{"type":"string","title":"Target Jurisdiction","default":"EU"},"purpose":{"type":"string","title":"Purpose","default":"audit"}},"type":"object","required":["ves_id","source_domain","target_domain"],"title":"CrossDomainRequest"}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Enter your VeriSigil API key. Get one at verisigilai.com/auth"}}}}