{
  "openapi": "3.2.1",
  "info": {
    "title": "Axiom Platform API",
    "description": "Axiom is programmable insurance infrastructure: one engine for every line of\ninsurance, where the rules are data and every decision can be explained to the\nperson it affects.\n\n## Overview\n\nAxiom provides a complete REST API across the five universal insurance\nprimitives \u2014 parties/roles, covers/products, policies/versions,\npremiums/payments, and events/assertions (under the governed contract). Every feature is\ndesigned API-first under the governed contract.\n\n## Authentication\n\nAll API requests (except health checks) require:\n- **Bearer token** via `Authorization` header (JWT from auth service)\n- **Tenant context** via `X-Tenant-Context` header (server-minted token, required on tenant-scoped endpoints)\n\n## Response Format\n\nMost endpoints currently return a legacy envelope format:\n```json\n{\n  \"data\": { ... },\n  \"status\": \"success\",\n  \"message\": \"optional description\"\n}\n```\n\nError responses:\n```json\n{\n  \"error\": \"Human-readable error message\",\n  \"status\": \"error\"\n}\n```\n\nNewer endpoints (inbox, ingress, webhooks, vendors) use the JSON:API format\nunder the governed contract. Migration of legacy endpoints to JSON:API is planned.\n\n## Pagination\n\nList endpoints declare their pagination profile per operation. Converged\npublic and application-visible list endpoints use cursor-based pagination:\n- `page[size]` \u2014 maximum items per page\n- `page[after]` \u2014 opaque cursor from the previous page\n- `page[before]` \u2014 opaque cursor for reverse traversal, only where the\n  operation explicitly documents support\n\nCursor response metadata includes `has_more`, `next_cursor`, and may include\n`prev_cursor` where reverse traversal is supported.\n\nExample cursor metadata:\n```json\n{\n  \"data\": [...],\n  \"meta\": { \"has_more\": true, \"next_cursor\": \"opaque-token\" },\n  \"status\": \"success\"\n}\n```\n\n## Correlation Tracing\n\nInclude `X-Correlation-ID` header for end-to-end request tracing.\nIf omitted, the server generates one. The response always includes\n`X-Correlation-ID` for support reference.\n\n## Versioning\n\nAPI families are in the URL path (`/v1/...`). The published contract\nversion is SemVer and is emitted in `info.version`, `X-API-Version`, and\nresponse telemetry under the governed contract.\n\n## Rate Limiting\n\nWhen a tenant-scoped route has an active runtime rate-limit policy,\nresponses include budget headers:\n- `X-RateLimit-Limit` \u2014 active tenant policy limit for the route\n- `X-RateLimit-Remaining` \u2014 remaining requests in the current window\n- `X-RateLimit-Reset` \u2014 window reset time (Unix timestamp)\n\nRejected calls return `429` with `Retry-After`.\n",
    "version": "0.2.126",
    "contact": {
      "name": "Axiom Platform Team",
      "email": "hello@axiom.express"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://axiom.express/license"
    }
  },
  "servers": [
    {
      "url": "https://api.afr-dev.axiom.express",
      "description": "Africa developer preview"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Analytics",
      "description": "Dashboard metrics, retained claim-family compatibility analysis, revenue trends, and product performance.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Audit",
      "description": "Audit trail \u2014 recent audit entries for compliance and debugging.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Catalogue",
      "description": "Catalogue parent lifecycle, bi-temporal entries, temporal values, relationships, labels, descriptor, source provenance, and bulk-write operations. Governed by governed contract.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Claim",
      "description": "Claims processing \u2014 submission, assessment, payment, and closure.\nStatus: submitted \u2192 assessing \u2192 assessed \u2192 approved \u2192 paying \u2192 paid \u2192 closed.\nAlso: submitted \u2192 rejected \u2192 closed.\nDeprecated (RFC-8594; Sunset 2026-08-31) in favour of Assertion.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Communications",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Compliance",
      "description": "Compliance evaluation engine (governed contract). Evaluates subjects against\nregulatory requirements and produces compliance reports.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Contract",
      "description": "Generated OpenAPI contract served by the deployed API binary.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Cover",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Event",
      "description": "Event and assertion workflows exposed in the developer-preview API.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Evidence",
      "description": "Evidence records and packs for audit and compliance (governed contract).\nTamper-evident records with content hashing and integrity verification.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Health",
      "description": "Service health and readiness checks. No authentication required.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Identity",
      "description": "Authenticated actor, admitted tenant discovery, and tenant-context bootstrap.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Ingress",
      "description": "Async event ingestion (governed contract). Conditionally available event intake with\ntransformation pipeline support. Uses JSON:API response format.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Ledger",
      "description": "Double-entry accounting ledger \u2014 entries, transactions, account balances,\nreversals, integrity verification, and reconciliation. Supports as-of\ntemporal queries with explanation traces.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Lifecycle Authoring",
      "description": "Insurance lifecycle authoring \u2014 tenant-owned lifecycle definitions,\ncompliance packs, validation, publication, and bindings. This is governed\ninsurance product grammar and does not expose generic workflow/BPMN\nauthoring, public PipelineTemplate authoring, or raw public rule evaluation.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Party",
      "description": "Party management \u2014 individuals, organisations, brokers, agents, and providers.\nParties are the actors in the policy lifecycle (policyholder roles,\nasserting parties, beneficiary roles, capacity-bearing parties).\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Party Group",
      "description": "Composable party-grouping primitive under the governed contract. Groups can contain\nparties and other groups (polymorphic DAG membership), support static\nand dynamic (CEL-rule-driven) membership, and can hold roles in their\nown right without inheriting to member parties. Distinct from Policy\nGroup (governed contract) which groups policies for cover application.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Payment",
      "description": "Payment processing \u2014 payment records and payment schedule management.\nSupports bank transfer, credit card, debit order, and other methods.\nStatus: pending \u2192 processing \u2192 completed \u2192 failed \u2192 cancelled.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Policy",
      "description": "Policy lifecycle \u2014 creation, versioning, endorsements, and status transitions.\nA policy binds a product to parties with specific terms and coverage dates.\nStatus: draft \u2192 active \u2192 suspended \u2192 cancelled \u2192 expired \u2192 lapsed.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Premium",
      "description": "Premium management \u2014 billing records and premium calculation engine.\nIncludes standalone premium CRUD and product-based calculation with\nadjustments and commission breakdowns.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Product",
      "description": "Insurance product catalogue \u2014 product definitions, covers, cover provisions,\nterms, pricing rules, and commissions. Products are templates from which\npolicies are created. Supports motor, property, health, life, liability, and more.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Report",
      "description": "Report generation and export (PDF, CSV).\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Ruleset",
      "description": "Business rules engine \u2014 rulesets, rules, testing, and deployment.\nRules are data.: explicit, versioned, deterministic, auditable.\nSupports CEL expressions, conditions, and actions.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Rulesets",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Schema Registry",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "SupportRequests",
      "description": "Tenant-facing support request intake and status over the canonical\ncollaboration_request substrate. Internal triage, support-session approval,\nCouncil escalation, product commitment, and SDLC conversion operations are\nexcluded from the public Support API.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "SupportSessions",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Tenant Schema",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Vendor",
      "description": "Vendor registry and risk management (governed contract). Tracks vendors,\nintegrations, data access, and subprocessor approvals.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Webhook",
      "description": "Outbound webhook dispatch (governed contract). Register webhook endpoints\nand track delivery status. Uses JSON:API response format.\n\nPublic maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "Workroom",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "access",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "consent",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "history",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    },
    {
      "name": "identity",
      "description": "Public maturity: Developer preview. This surface is available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0.",
      "x-axiom-public-maturity": {
        "availability": "developer-preview",
        "stability": "evolving",
        "response_profile": "endpoint-specific",
        "usage": "available",
        "published": true,
        "authorisation": "requires-issued-alpha-access-pack",
        "alpha_access_required": true,
        "production_ready": false,
        "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
      }
    }
  ],
  "paths": {
    "/openapi": {
      "get": {
        "operationId": "getOpenAPIContract",
        "summary": "Get the deployed OpenAPI contract",
        "description": "Returns the generated OpenAPI 3 contract embedded in the running API binary.\nThe SHA-256 digest of this exact document is exposed on `/v1/health` under\n`contract.sha256` for deployed-contract verification.\n",
        "tags": [
          "Contract"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Generated OpenAPI 3 contract for the deployed API binary.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "openapi",
                    "info",
                    "paths"
                  ],
                  "additionalProperties": true,
                  "properties": {
                    "openapi": {
                      "type": "string",
                      "pattern": "^3\\.",
                      "example": "3.2.1"
                    },
                    "info": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "paths": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Contract endpoint not found (misconfigured route).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "not-required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "not-applicable",
          "tenant_context": "not-required",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "no-authentication-required"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "not-required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/openapi": {
      "get": {
        "operationId": "getVersionedOpenAPIContract",
        "summary": "Get the deployed OpenAPI contract",
        "description": "Versioned alias for `/openapi`. Returns the generated OpenAPI 3 contract\nembedded in the running API binary.\n",
        "tags": [
          "Contract"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Generated OpenAPI 3 contract for the deployed API binary.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "openapi",
                    "info",
                    "paths"
                  ],
                  "additionalProperties": true,
                  "properties": {
                    "openapi": {
                      "type": "string",
                      "pattern": "^3\\.",
                      "example": "3.2.1"
                    },
                    "info": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "paths": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Contract endpoint not found (misconfigured route).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "not-required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "not-applicable",
          "tenant_context": "not-required",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "no-authentication-required"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "not-required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/health": {
      "get": {
        "operationId": "getHealth",
        "tags": [
          "Health"
        ],
        "summary": "Check API health",
        "description": "Returns the current developer-facing API health status. Use this endpoint for connectivity checks and include X-Correlation-ID when escalating an unexpected result.",
        "security": [],
        "responses": {
          "200": {
            "description": "API is reachable.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "healthy",
                      "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "version": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "status": "healthy",
                  "timestamp": "2026-08-09T00:00:00Z",
                  "version": "0.2.126"
                }
              }
            }
          },
          "503": {
            "description": "API is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "unavailable",
                      "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                    },
                    "timestamp": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                },
                "example": {
                  "status": "unavailable",
                  "timestamp": "2026-08-09T00:00:00Z"
                }
              }
            }
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "endpoint-specific",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "not-required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "not-applicable",
          "tenant_context": "not-required",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "no-authentication-required"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "not-required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/uploads": {
      "post": {
        "operationId": "initiateObjectUpload",
        "summary": "Initiate a presigned object upload",
        "description": "Returns a short-lived presigned PUT URL the caller uses to upload a binary\npayload directly to object storage (S3-compatible), bypassing the API for\nthe bytes themselves. The returned `upload_id` is then referenced in a\ndownstream ingest call (e.g. POST /v1/catalogues/{catalogue-ref}/bulk-write).\n\nRequires the `catalogue.bulk_write` capability (scope\n`catalogues:bulk-write`) from the caller's grant in the operating tenant \u2014\nthe same authority that may submit the staged object to bulk-write. No\nKeycloak realm role is required.\n\nThe response is a bare `{data: ...}` envelope (no `status` field).\n",
        "tags": [
          "Evidence"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:bulk-write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Presigned upload initiated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/objectUploadInitiateResponse"
                },
                "example": {
                  "data": {
                    "upload_id": "ref_20260408_0001",
                    "put_url": "https://api.afr-dev.axiom.express/v1/objects/ref_20260408_0001?X-Amz-Signature=...",
                    "object_uri": "managed-object://redacted",
                    "expires_at": "2026-06-02T13:00:00Z"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "The deny response when the caller's grant lacks `catalogue.bulk_write` (governed contract Decision 1).",
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:bulk-write"
          ],
          "required_permissions": [
            "catalogues:bulk-write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "presigned-upload-initiation",
            "api_byte_transport": "metadata-only",
            "numeric_byte_limit": "not-published",
            "commitment_status": "unavailable",
            "enforcement_owner": "object-store-presigned-put",
            "replacement_decision": "Publish an object-size commitment only when the presigned PUT flow exposes a runtime-enforced content-length-range condition or equivalent object-store policy proof."
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/jobs/{job_id}": {
      "get": {
        "operationId": "getJobStatus",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "async-job-execution-status",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Get async job status",
        "description": "Returns the current state of an async job. Terminal states\n(`succeeded`, `failed`, `dead_letter`) are cacheable; non-terminal states\n(`queued`, `running`) are returned with no-store.\n\nThe response is a bare `{data: ...}` envelope (no `status` field).\n\nThis operation reports workqueue execution status only. It does not expose\n`workflow_execution_id`, does not promise workflow execution tracking, and\nmust not be treated as a public workflow execution registry.\n",
        "tags": [
          "Contract"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^job_[0-9a-hjkmnp-tv-z]{26}$",
              "format": "typed-prefix-id",
              "example": "job_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "work-item-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed work-item job identifier for the async job to poll.",
            "example": "job_00000000000000000000000456"
          }
        ],
        "responses": {
          "200": {
            "description": "Job status.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/jobStatusResponse"
                },
                "example": {
                  "data": {
                    "id": "job_00000000000000000000000456",
                    "kind": "catalogue.ingest",
                    "state": "running",
                    "submitted_at": "2026-06-02T12:00:00Z",
                    "attempt": 1,
                    "max_attempts": 3,
                    "progress": {
                      "completed_units": 1200,
                      "total_units": 5000,
                      "message": "ingesting entries"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/replacements": {
      "post": {
        "operationId": "initiateReplacement",
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "policy-replacement-workflow",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Initiate a policy replacement",
        "description": "Starts a replacement workflow that supersedes one or more existing policies\nwith a replacement policy. Returns the initial workflow state including the\nallowed transitions from the starting step.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/replacementInitiateRequest"
              },
              "example": {
                "policy_id": "pol_01j1234567890abcdefghijk",
                "existing_policy_ids": [
                  "pol_01j9876543210abcdefghijk"
                ],
                "jurisdiction_code": "za",
                "actor": {
                  "actor_type": "human",
                  "actor_id": "usr_01j1234567890abcdefghijk",
                  "actor_original_id": "usr_01j1234567890abcdefghijk"
                },
                "reason": "Customer requested upgrade to comprehensive cover",
                "occurred_at": "2026-06-02T12:00:00Z"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Replacement workflow initiated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/replacementSingleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/replacements/{id}": {
      "get": {
        "operationId": "getReplacement",
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "policy-replacement-workflow",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Get a replacement workflow",
        "description": "Fetch the current state of a replacement workflow by id.",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/ReplacementIdPath"
          }
        ],
        "responses": {
          "200": {
            "description": "Replacement workflow state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/replacementSingleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/replacements/{id}/advance": {
      "post": {
        "operationId": "advanceReplacement",
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "policy-replacement-workflow",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Advance a replacement workflow",
        "description": "Advances the workflow to the next step, supplying the evidence payload\nrequired by the current step. Optimistic-concurrency via `version`.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/ReplacementIdPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/replacementAdvanceRequest"
              },
              "example": {
                "actor": {
                  "actor_type": "human",
                  "actor_id": "usr_01j1234567890abcdefghijk",
                  "actor_original_id": "usr_01j1234567890abcdefghijk"
                },
                "reason": "Replacement disclosure acknowledged",
                "occurred_at": "2026-06-02T12:05:00Z",
                "evidence_payload": {
                  "disclosure_acknowledged": true
                },
                "version": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Replacement advanced.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/replacementSingleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/replacements/{id}/cancel": {
      "post": {
        "operationId": "cancelReplacement",
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "policy-replacement-workflow",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Cancel a replacement workflow",
        "description": "Cancels an in-flight replacement workflow. Optimistic-concurrency via `version`.",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/ReplacementIdPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/replacementCancelRequest"
              },
              "example": {
                "actor": {
                  "actor_type": "human",
                  "actor_id": "usr_01j1234567890abcdefghijk",
                  "actor_original_id": "usr_01j1234567890abcdefghijk"
                },
                "reason": "Customer withdrew request",
                "occurred_at": "2026-06-02T12:10:00Z",
                "version": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Replacement cancelled.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/replacementSingleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/replacements/{id}/evidence": {
      "get": {
        "operationId": "getReplacementEvidence",
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "policy-replacement-workflow",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Get replacement evidence",
        "description": "Returns the evidence collected per step for a replacement workflow.",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/ReplacementIdPath"
          }
        ],
        "responses": {
          "200": {
            "description": "Replacement evidence.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/replacementEvidenceResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/archive/objects": {
      "post": {
        "operationId": "ingestArchiveObject",
        "summary": "Upload an object to the archive",
        "description": "Multipart upload of a single binary payload into the Axiom archive.\nThe `file` part is required; `original_filename`, `mime_type`, and `source`\nare optional. When omitted, the API derives them from the file header,\nContent-Type, and literal source `\"api\"`.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The binary payload to archive."
                  },
                  "original_filename": {
                    "type": "string",
                    "description": "Original filename; falls back to the upload part's filename."
                  },
                  "mime_type": {
                    "type": "string",
                    "description": "MIME type; falls back to the part Content-Type or application/octet-stream."
                  },
                  "source": {
                    "type": "string",
                    "description": "Provenance tag (default \"api\")."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Object archived.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArchiveIngestResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "multipart-form-data",
            "parse_memory_bytes": 33554432,
            "numeric_request_byte_limit": 67108864,
            "file_count_limit": 10,
            "enforcement": "runtime"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/support-session-disclosures": {
      "get": {
        "operationId": "listSupportSessionDisclosures",
        "summary": "List tenant support-session disclosures",
        "description": "List the bounded support-session disclosure history for the authenticated\noperating tenant. This route requires normal tenant context and never takes\nthe tenant id from caller-supplied path or query input.\n",
        "tags": [
          "SupportSessions"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Support-session disclosures retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportSessionDisclosureListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/support/requests": {
      "post": {
        "operationId": "createSupportRequest",
        "summary": "Submit a support request",
        "description": "Submit a support, incident, bug, enhancement, feature, documentation,\nintegration, or commercial request into the canonical\n`collaboration_request` support lifecycle. Email and assisted support channels are\nadapter references only; this operation creates the same canonical record\ntype. Public callers cannot approve support access, create internal work, make\nproduct commitments, or force internal lifecycle transitions.\n",
        "tags": [
          "SupportRequests"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/SupportRequestCorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/SupportRequestIdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSupportRequestRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Support request accepted into the collaboration_request lifecycle.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportRequestResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listSupportRequests",
        "summary": "List visible support requests",
        "description": "List support requests visible to the authenticated actor in the current\ntenant/account scope. The response is tenant-isolated and exposes only\nredacted tenant-facing state and affordances.\n",
        "tags": [
          "SupportRequests"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/SupportRequestCorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/PageSize-2"
          },
          {
            "$ref": "#/components/parameters/PageAfter-2"
          }
        ],
        "responses": {
          "200": {
            "description": "Support requests retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportRequestListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/support/requests/{request_id}": {
      "get": {
        "operationId": "getSupportRequest",
        "summary": "Read a visible support request",
        "description": "Read one support request visible to the authenticated actor in the current\ntenant/account scope. Internal work links, support-session internals,\nCouncil material, and private triage notes are not tenant-facing authority.\n",
        "tags": [
          "SupportRequests"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/SupportRequestId"
          },
          {
            "$ref": "#/components/parameters/SupportRequestCorrelationHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Support request retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportRequestResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/support/requests/{request_id}/messages": {
      "post": {
        "operationId": "addSupportRequestMessage",
        "summary": "Add a support request message",
        "description": "Add a tenant-visible follow-up message to a support request thread. This\noperation appends communication content only; it cannot force internal\nstate transitions such as accepted, converted_to_sdlc_intent, closed, or\nreopened.\n",
        "tags": [
          "SupportRequests"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/SupportRequestId"
          },
          {
            "$ref": "#/components/parameters/SupportRequestCorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/SupportRequestIdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddSupportRequestMessageRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Message appended.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportRequestResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/support/requests/{request_id}/attachments": {
      "post": {
        "operationId": "addSupportRequestAttachment",
        "summary": "Attach support evidence by custody reference",
        "description": "Attach or reference evidence that has already entered governed object\ncustody. Raw URLs and adapter attachments are not evidence authority for\nthis operation.\n",
        "tags": [
          "SupportRequests"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/SupportRequestId"
          },
          {
            "$ref": "#/components/parameters/SupportRequestCorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/SupportRequestIdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SupportAttachmentReference"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Attachment reference added.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportRequestResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/events": {
      "get": {
        "description": "Contract authority for GET /v1/events (listEvents) in the Events/Assertions portfolio. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "listEvents",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "events:read"
            ]
          }
        ],
        "summary": "List Events",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "events:read"
          ],
          "required_permissions": [
            "events:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-nonread",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/events/{id}": {
      "get": {
        "description": "Contract authority for GET /v1/events/{id} (getEvent) in the Events/Assertions portfolio. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "getEvent",
        "parameters": [
          {
            "description": "Event id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "evt_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "pattern": "^evt_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-classification": "event-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "events:read"
            ]
          }
        ],
        "summary": "Get Event",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "events:read"
          ],
          "required_permissions": [
            "events:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-nonread",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/events/{event_id}/documents": {
      "post": {
        "description": "Contract authority for POST /v1/events/{event_id}/documents (uploadEventDocuments) in the Events/Assertions portfolio. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "uploadEventDocuments",
        "parameters": [
          {
            "description": "Event id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "evt_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "event_id",
            "required": true,
            "schema": {
              "pattern": "^evt_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-classification": "event-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/UploadEventDocumentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UploadEventDocumentsResponse"
                }
              }
            },
            "description": "Documents ingested and linked."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "events:document"
            ]
          }
        ],
        "summary": "Upload Event Documents",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "events:document"
          ],
          "required_permissions": [
            "events:document"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "multipart-form-data",
            "parse_memory_bytes": 33554432,
            "numeric_request_byte_limit": 67108864,
            "file_count_limit": 10,
            "enforcement": "runtime"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/events/report": {
      "post": {
        "description": "Record a tenant-reported event with supporting documents. An event is the occurrence half of the Axiom Events/Assertions pair \u2014 it captures what happened, who reported it, and what documentary evidence supports it. An assertion is the resulting contract response. Retry safety is enforced by the shared Idempotency-Key API: an exact semantic replay returns the original response and a key reused with a different request conflicts. For multipart retries, generated boundaries and ordering between differently named parts are transport details. Order among repeated same-name parts remains part of the fingerprint because it can change form-parser meaning; field names, filenames, media types, multiplicity, and content remain part of the fingerprint. The shared 64 MiB request-body limit is enforced before idempotency buffering regardless of caller-supplied media type, and again before multipart form parsing. At most ten binary file parts are accepted per request; an eleventh file is rejected with HTTP 400 and canonical error code INVALID_REQUEST. Ledger effects, if any, are produced by downstream rules evaluation against the stored event.",
        "operationId": "reportEventWithDocuments",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/EventReportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventReportResponse"
                }
              }
            },
            "description": "Event reported with documents."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "events:report"
            ]
          }
        ],
        "summary": "Report Event",
        "tags": [
          "Event",
          "Evidence"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "events:report"
          ],
          "required_permissions": [
            "events:report"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "multipart-form-data",
            "parse_memory_bytes": 33554432,
            "numeric_request_byte_limit": 67108864,
            "file_count_limit": 10,
            "enforcement": "runtime"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/events/{id}/proration-adjustments": {
      "post": {
        "description": "Evaluate and persist a tenant-owned event-effective proration decision for an existing event/assertion. The operation creates an immutable proration decision with typed components. Financial components may post through the ledger; non-financial components are durable decision inputs consumed by dynamic balance and temporal engines.",
        "operationId": "applyProrationAdjustment",
        "parameters": [
          {
            "description": "Event id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "evt_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "pattern": "^evt_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-classification": "event-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProrationAdjustmentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProrationAdjustmentResponse"
                }
              }
            },
            "description": "Proration adjustment decision applied."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "events:proration-adjust"
            ]
          }
        ],
        "summary": "Apply Proration Adjustment",
        "tags": [
          "Event",
          "Premium",
          "Policy",
          "Cover"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "events:proration-adjust"
          ],
          "required_permissions": [
            "events:proration-adjust"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/role-types": {
      "get": {
        "operationId": "listRoleTypes",
        "summary": "List available party role types",
        "description": "Returns the catalogue of party role types available to the tenant. This\nis the permissible role_type vocabulary and metadata, not the set of role\ntypes currently in use. Use `GET /v1/parties/role-types/usage` for active\nassignment counts.\n\nRuntime source: the tenant `catalogue.role_types` table. Bootstrap\nregistry metadata may enrich known seed codes, but the tenant catalogue is\nthe authority for which role_type values are available.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          }
        ],
        "responses": {
          "200": {
            "description": "Available party role types",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoleTypeListResponse"
                },
                "example": {
                  "data": [
                    {
                      "code": "policyholder",
                      "display_name": "Policyholder",
                      "universal": true,
                      "assignable_context_types": [
                        "policy",
                        "policy_item"
                      ],
                      "requires_attribution": true
                    },
                    {
                      "code": "beneficiary",
                      "display_name": "Beneficiary",
                      "universal": true,
                      "assignable_context_types": [
                        "policy",
                        "policy_item"
                      ],
                      "requires_attribution": true
                    }
                  ],
                  "meta": {
                    "total": 18,
                    "limit": 18,
                    "offset": 0
                  },
                  "status": "success"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/role-types/usage": {
      "get": {
        "operationId": "listRoleTypeUsage",
        "summary": "Role-type usage counts",
        "description": "Returns each role type that has at least one active (non-revoked)\nassignment for the tenant, with the count of holders. Role types in the\nregistry with zero holders are not returned \u2014 pair with\n`GET /v1/parties/role-types` to render \"available but unused\" rows.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          }
        ],
        "responses": {
          "200": {
            "description": "Role-type usage counts",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoleTypeUsageListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties": {
      "post": {
        "description": "Register a party identity record that may later carry roles. A party is the foundational Axiom primitive anchoring all relationships \u2014 to covers, policies, premiums, and events. This contract creates the identity record; role assignment is a separate operation.",
        "operationId": "createParty",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePartyRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyResponse"
                }
              }
            },
            "description": "Party created successfully"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Invalid request, including invalid lifecycle transition shape such as status=merged without merged_into_party_id"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Authentication required"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Insufficient permissions"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "parties:register"
            ]
          }
        ],
        "summary": "Register Party",
        "tags": [
          "Party"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "parties:register"
          ],
          "required_permissions": [
            "parties:register"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listParties",
        "summary": "List parties",
        "description": "Retrieve a paginated list of parties for the tenant.\nResults are sorted by created_at descending. Sort order is not configurable.\n\nSupports cursor-based pagination via page[size] and page[after] query parameters.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of parties to return in this cursor page."
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor returned as meta.next_cursor by the previous page."
          },
          {
            "name": "source_system",
            "in": "query",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/PartyExternalIDSourceSystem"
            },
            "description": "Exact external identifier source-system filter. Must be supplied together with external_id; unknown values return 400 INVALID_REQUEST with accepted values in the error detail."
          },
          {
            "name": "external_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "tenant-external-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Exact external identifier filter. Must be supplied together with source_system so bare external_id cannot create ambiguous identity resolution."
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "minLength": 3
            },
            "description": "Free-text search term for Party lookup. The runtime rejects search terms shorter than three characters."
          },
          {
            "name": "role",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Tenant `catalogue.role_types` code filter for parties currently holding the role."
          }
        ],
        "responses": {
          "200": {
            "description": "Parties retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "source_system",
            "external_id",
            "q",
            "role"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}": {
      "get": {
        "operationId": "getParty",
        "summary": "Get a party by ID",
        "description": "Retrieve a single party by its unique identifier, including any assigned roles.\nWhen as_of or recorded_at is supplied, the response replays the party from\nthe immutable party history substrate using effective time and recorded time\nas-was semantics.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "RFC3339 effective-time timestamp for party history replay. Defaults to current effective time."
          },
          {
            "name": "recorded_at",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "RFC3339 recorded-time timestamp for as-was party history replay. Defaults to the latest recorded version."
          }
        ],
        "responses": {
          "200": {
            "description": "Party retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "recorded_at"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "put": {
        "operationId": "updateParty",
        "summary": "Update a party",
        "description": "Update an existing party's display name, attributes and/or status.\nOmitted fields retain their saved values. Supplied attributes replace the\nattributes object. Display name is independent of attributes: null clears it,\nwhile a supplied string must contain a non-whitespace character.\nSupply supersedes_row_id to correct a currently-believed history row,\npreserving its validity interval; omit it for an ordinary update.\n\nSide effects: updates the party record; emits an audit entry recording the change.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256
            },
            "description": "Replay the original response for an identical operation, tenant, target and payload. Reusing a key with different request content returns 409."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePartyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Party updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Party or currently-believed correction target unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/roles": {
      "get": {
        "operationId": "getPartyRoles",
        "summary": "Get roles assigned to a party",
        "description": "Retrieve all role assignments for a party across policies, claims, and other entities.\nEach role includes the context (entity type and ID) it is scoped to.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Party roles retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyRoleListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "addPartyRole",
        "summary": "Assign a role to a party",
        "description": "Assign a new role to a party, scoped to a specific entity (e.g. a policy,\nclaim, product, organization, policy item, or PartyGroup). For sponsor\nrole assignments on a group context, the sponsor remains the Party role\nassignee and the PartyGroup is identified by entity_type=group/entity_id.\nOnly one active sponsor is allowed per tenant/group context; duplicate\nactive sponsor attempts return SPONSOR_CARDINALITY_VIOLATED (HTTP 409).\n\nA party can hold multiple roles simultaneously, and the same party can hold\ndifferent roles on different entities.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "role_type",
                  "entity_type",
                  "entity_id",
                  "assigned_by"
                ],
                "properties": {
                  "role_type": {
                    "type": "string",
                    "description": "Tenant `catalogue.role_types` code to assign. The server validates the code against the tenant catalogue, not a closed OpenAPI enum."
                  },
                  "entity_type": {
                    "type": "string",
                    "enum": [
                      "policy",
                      "claim",
                      "organization",
                      "product",
                      "policy_item",
                      "group"
                    ],
                    "description": "The type of entity this role is scoped to"
                  },
                  "entity_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "description": "The identifier of the entity this role is scoped to",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "assigned_by": {
                    "type": "string",
                    "description": "Identifier of the user or service assigning this role"
                  },
                  "attributes": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": true,
                    "description": "Optional attributes for the role assignment"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Role assigned successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyRoleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/contacts": {
      "get": {
        "operationId": "listPartyContacts",
        "summary": "List contacts for a party",
        "description": "Retrieve all contact records associated with a party. A party may have multiple\ncontacts (e.g. personal email, work email, mobile, landline).\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Contacts retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyContactListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createPartyContact",
        "summary": "Add a contact to a party",
        "description": "Create a new contact record for a party. Each contact includes an email address,\nphone number, and/or preferred contact method. Parties in opted_out status reject\nnew contact capture with a 409 while historical contact reads remain available.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePartyContactRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Contact created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyContactResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/contacts/{contactId}": {
      "put": {
        "operationId": "updatePartyContact",
        "summary": "Update a party contact",
        "description": "Update an existing contact record for a party.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "contactId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id"
            },
            "description": "Unique contact identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePartyContactRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Contact updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyContactResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "delete": {
        "operationId": "deletePartyContact",
        "summary": "Delete a party contact",
        "description": "Remove a contact record from a party.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "contactId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id"
            },
            "description": "Unique contact identifier"
          }
        ],
        "responses": {
          "204": {
            "description": "Contact deleted successfully"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/identities": {
      "get": {
        "operationId": "listPartyIdentities",
        "summary": "List identity documents for a party",
        "description": "Retrieve all identity documents associated with a party (e.g. passport, national ID,\ntax number, company registration). Each identity has a verification status.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Identities retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyIdentityListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createPartyIdentity",
        "summary": "Add an identity document to a party",
        "description": "Register a new identity document for a party. The identity is created in\n\"pending\" status and must be verified separately via the verify endpoint.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePartyIdentityRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Identity document created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyIdentityResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/identities/{identityId}/verify": {
      "post": {
        "operationId": "verifyPartyIdentity",
        "summary": "Verify a party identity document",
        "description": "Record a verification decision for an identity belonging to the URL party.\nA rejected decision is stored with the catalogue status \"failed\". Authenticated\nactor context supplies attribution; verified_by is compatibility metadata.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "identityId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id"
            },
            "description": "Unique identity document identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "status",
                  "verified_by"
                ],
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "verified",
                      "rejected"
                    ]
                  },
                  "verified_by": {
                    "type": "string",
                    "description": "Required compatibility metadata; authenticated actor supplies attribution."
                  },
                  "notes": {
                    "type": "string",
                    "description": "Optional compatibility metadata; not retained as verification evidence."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Identity verified successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyIdentityResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/relationships": {
      "get": {
        "operationId": "getPartyRelationships",
        "summary": "List relationships for a party",
        "description": "Retrieve relationships for a party. The view parameter selects the response shape:\n\n- list (default): returns all active relationships as a flat array of relationship objects.\n- distribution_chain: traverses the distribution chain from this party, returning\n  participants and an explanation tree (governed contract).\n\nDistribution traversal refuses multiple active records on the same directed\nedge in the reachable filtered component with 409 PARTY_RELATIONSHIP_EDGE_AMBIGUOUS.\nNarrow relationship_type or as_of to identify one record per directed edge.\nParallel relationship records remain available in the list view.\n\nAn unrecognised view value returns 400 INVALID_REQUEST under the governed contract.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "view",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "list",
                "distribution_chain"
              ],
              "default": "list"
            },
            "description": "Response view type. Unknown values return 400 INVALID_REQUEST under the governed contract."
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Point-in-time filter for relationships (ISO 8601). Defaults to current time."
          },
          {
            "name": "relationship_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated tenant `catalogue.relationship_types` code filter."
          },
          {
            "name": "max_depth",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 16
            },
            "description": "Maximum traversal depth for view=distribution_chain (1-16). Ignored for view=list."
          }
        ],
        "responses": {
          "200": {
            "description": "Relationships retrieved successfully. Shape depends on the view parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/PartyRelationshipListResponse"
                    },
                    {
                      "$ref": "#/components/schemas/PartyDistributionChainResponse"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "relationship_type",
            "max_depth"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createPartyRelationship",
        "summary": "Create a relationship between two parties",
        "description": "Creates a directed relationship from the identified party (from_party_id) to another\nparty (to_party_id). On success, returns 201 Created with the new relationship resource.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "to_party_id",
                  "relationship_type"
                ],
                "properties": {
                  "to_party_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "description": "Target party for the relationship",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "relationship_type": {
                    "type": "string",
                    "description": "Tenant `catalogue.relationship_types` code. The server validates the code against the tenant catalogue, not a closed OpenAPI enum."
                  },
                  "effective_from": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Relationship valid-from timestamp (ISO 8601). Defaults to now."
                  },
                  "effective_to": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Relationship expiry timestamp. Null means open-ended."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": true,
                    "description": "Optional key-value metadata for the relationship"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Relationship created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyRelationshipResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/relationships/{relId}": {
      "delete": {
        "operationId": "deletePartyRelationship",
        "summary": "Delete (deactivate) a party relationship",
        "description": "Temporally deactivates a relationship by setting its effective_to to now.\nIdempotent \u2014 deactivating an already inactive relationship returns 204.\n\nBody `{\"reason\": \"...\"}` is required (non-blank after trim) per .\nBlank reason returns 400 PARTY_DEACTIVATION_REASON_REQUIRED.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "relId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id"
            },
            "description": "Unique relationship identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reason"
                ],
                "properties": {
                  "reason": {
                    "type": "string",
                    "description": "Non-blank rationale for the deactivation. Recorded on the audit record under the governed contract."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Relationship deleted (deactivated) successfully"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/party-groups": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "listGroupsForParty",
        "summary": "List party groups containing this party",
        "description": "Inverse projection \u2014 returns the groups the given party is a member\nof as of `as_of`. Distinct from `/v1/parties/:id/groups` which\nreturns Policy Group (governed contract) memberships.\n",
        "tags": [
          "Party",
          "Party Group"
        ],
        "parameters": [
          {
            "name": "as_of",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Groups the party belongs to",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/groups": {
      "get": {
        "operationId": "listPartyPolicyGroups",
        "summary": "List the policy-driven groups a party belongs to",
        "description": "Returns the **transitive** policy-group membership view for a party: the\ngroups the party belongs to by virtue of a policy binding, each annotated\nwith the `via_policy_id` that confers the membership. This is distinct\nfrom `/v1/parties/{id}/party-groups` (first-class, directly-assigned\nparty-group memberships) \u2014 here membership is derived from policy\nparticipation, not a direct grouping assignment.\n\nPoint-in-time: pass `as_of` (RFC3339) to resolve membership as it stood at\nthat instant; defaults to now.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Resolve membership as-of this instant (RFC3339). Defaults to now."
          }
        ],
        "responses": {
          "200": {
            "description": "Policy-driven group memberships for the party",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyPolicyGroupListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/payments": {
      "get": {
        "operationId": "getPartyPayments",
        "summary": "List payments for a party",
        "description": "Retrieves a paginated list of payments associated with a specific party.\nReturns only payments explicitly linked to the party via `party_id`.\nPayments without party linkage (null `party_id`) are excluded.\n\nResults are sorted by created_at descending with id as a stable\ntie-breaker. Use `page[size]` and `page[after]` for pagination. Legacy\n`limit` and `offset` query parameters are rejected.\n",
        "tags": [
          "Party",
          "Payment"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of payments to return"
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor returned as `meta.next_cursor` by the previous page."
          }
        ],
        "responses": {
          "200": {
            "description": "Party payments retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyPaymentListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/audit": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "listPartyAudit",
        "summary": "Chronological audit feed for a party",
        "description": "Returns the per-party audit feed in chronological order\n(`performed_at DESC`). Each event carries governed contract actor attribution\n(`actor_id` / `actor_type` / `actor_original_id`) regardless of\nwriter path. The reader merges persistence-managed records and application writes\nso the consumer sees a single shape.\n\nExplanation enrichment fields (`decision_id`, `rule_versions`,\n`inputs`) are populated for rules-evaluation records only and\nempty otherwise (preview placeholder).\n\nUse `page[size]` and `page[after]` for cursor pagination. Legacy\n`limit` and `offset` query parameters are rejected by the runtime.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "minimum": 1,
              "maximum": 200
            },
            "description": "Maximum number of audit entries to return in this cursor page."
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor returned as `meta.next_cursor` by the previous page."
          }
        ],
        "responses": {
          "200": {
            "description": "Audit feed for this party",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyAuditListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/history": {
      "get": {
        "description": "List authoritative party version coordinates in the operating tenant. Replay each available version with its returned as_of and recorded_at coordinates. Audit performed_at is not a version boundary. Historical reads never return current data in place of a missing version. Legacy reversed rows without a recorded belief closure have replay=null because their reversal time is unknown.",
        "operationId": "listPartyHistory",
        "parameters": [
          {
            "description": "Party id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "pty_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Maximum versions per page; ordered by recorded_at descending and row_id ascending.",
            "in": "query",
            "name": "page[size]",
            "required": false,
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Opaque next-page cursor scoped to this tenant and party.",
            "in": "query",
            "name": "page[after]",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyHistoryResponse"
                }
              }
            },
            "description": "Party version coordinates without party attribute or audit payloads."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "parties:read"
            ]
          }
        ],
        "summary": "List Party History",
        "tags": [
          "Party",
          "history"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "parties:read"
          ],
          "required_permissions": [
            "parties:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/audit": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "listPartyGroupAudit",
        "summary": "Chronological audit feed for a party group",
        "description": "Returns the per-group audit feed in chronological order\n(`performed_at DESC`). party_groups + party_group_memberships have\nno persistence-managed records, so every row is generated by the\napplication's `NewAuditRecord` path with a `party.group_*`\noperation code.\n\nResponse shape mirrors `/v1/parties/{id}/audit` \u2014 see that endpoint\nfor the full `AuditEntry` field list.\n\nUse `page[size]` and `page[after]` for cursor pagination. Legacy\n`limit` and `offset` query parameters are rejected by the runtime.\n",
        "tags": [
          "Party Group"
        ],
        "parameters": [
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 50,
              "minimum": 1,
              "maximum": 200
            },
            "description": "Maximum number of audit entries to return in this cursor page."
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor returned as `meta.next_cursor` by the previous page."
          }
        ],
        "responses": {
          "200": {
            "description": "Audit feed for this party group",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupAuditListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues": {
      "get": {
        "operationId": "listCatalogues",
        "summary": "List catalogues",
        "description": "Returns catalogue parents visible to the caller's tenant. Tenant-scoped\ncatalogues from other tenants are filtered out (not 404'd individually).\nTenant isolation is enforced at the persistence layer by tenant-isolated.\n\nOptional `slug` filter for exact slug match; `include_discarded` exposes\nsoft-discarded parents for audit / recovery purposes (defaults false).\n",
        "tags": [
          "Catalogue"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "name": "slug",
            "in": "query",
            "required": false,
            "description": "Exact catalogue slug filter (e.g. `icd-10-za`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_discarded",
            "in": "query",
            "required": false,
            "description": "When true, includes soft-discarded catalogue parents in the result.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of catalogue parents",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/catalogueListResponse"
                },
                "example": {
                  "data": [
                    {
                      "id": "ref_20260408_0001",
                      "slug": "icd-10-za",
                      "name": "ICD-10-ZA",
                      "source": "WHO/DoH-ZA",
                      "refresh_frequency": "annual",
                      "substrate": "bi-temporal",
                      "has_descriptor": false,
                      "created_at": "2026-01-15T08:00:00Z",
                      "updated_at": "2026-01-15T08:00:00Z"
                    }
                  ],
                  "meta": {
                    "limit": 0,
                    "offset": 0,
                    "count": 1
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "slug",
            "include_discarded"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createCatalogue",
        "summary": "Create catalogue",
        "description": "Bootstrap a new catalogue parent row for the caller's tenant.\nThe server assigns the UUID `id`; the caller supplies a human-friendly\n`slug` that becomes the stable URL identifier for all downstream routes.\n\nRequires the `catalogue.write` capability (scope `catalogues:write`) from the caller's\ngrant in the operating tenant; no Keycloak realm role is required.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createCatalogueRequest"
              },
              "example": {
                "slug": "icd-10-za",
                "name": "ICD-10-ZA",
                "source": "WHO/DoH-ZA",
                "refresh_frequency": "annual"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Catalogue created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/catalogueSingleResponse"
                },
                "example": {
                  "data": {
                    "id": "ref_20260408_0001",
                    "slug": "icd-10-za",
                    "name": "ICD-10-ZA",
                    "source": "WHO/DoH-ZA",
                    "refresh_frequency": "annual",
                    "substrate": "bi-temporal",
                    "has_descriptor": false,
                    "created_at": "2026-01-15T08:00:00Z",
                    "updated_at": "2026-01-15T08:00:00Z"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Not found. Also the deny response when the caller's grant lacks the route capability (governed contract Decision 1).",
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}": {
      "get": {
        "operationId": "getCatalogue",
        "summary": "Get catalogue",
        "description": "Fetch a single catalogue parent by its slug identifier. Returns\ndiscarded parents too (audit / as-was reconstruction); the\n`discarded_at`, `discarded_by`, and `discard_reason` fields are\npopulated when set.\n\nTenant isolation enforced at persistence layer by tenant-isolated. Cross-tenant\nslugs yield 404, not 403.\n",
        "tags": [
          "Catalogue"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "responses": {
          "200": {
            "description": "Catalogue parent",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/catalogueSingleResponse"
                },
                "example": {
                  "data": {
                    "id": "ref_20260408_0001",
                    "slug": "icd-10-za",
                    "name": "ICD-10-ZA",
                    "source": "WHO/DoH-ZA",
                    "refresh_frequency": "annual",
                    "substrate": "bi-temporal",
                    "has_descriptor": false,
                    "created_at": "2026-01-15T08:00:00Z",
                    "updated_at": "2026-01-15T08:00:00Z"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "delete": {
        "operationId": "discardCatalogue",
        "summary": "Soft-discard catalogue",
        "description": "Soft-discard a catalogue parent (sets `discarded_at`, `discarded_by`,\n`discard_reason`). under the governed contract + governed contract, hard-deleting a parent\nwould dangle every historical catalogue version, ingestion-provenance,\nand entry FK. The discarded parent remains visible via\nGET /v1/catalogues/{catalogue-ref} for audit purposes.\n\nA non-blank `reason` is required in the request body \u2014 a blank\njustification in the audit trail is explicitly rejected (fail-loud).\n\nRequires the `catalogue.write` capability (scope `catalogues:write`) from the caller's\ngrant in the operating tenant; no Keycloak realm role is required.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/discardCatalogueRequest"
              },
              "example": {
                "reason": "Superseded by ICD-11 catalogue"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Discarded catalogue parent (discarded_at populated)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/catalogueSingleResponse"
                },
                "example": {
                  "data": {
                    "id": "ref_20260408_0001",
                    "slug": "icd-10-za",
                    "name": "ICD-10-ZA",
                    "source": "WHO/DoH-ZA",
                    "refresh_frequency": "annual",
                    "substrate": "bi-temporal",
                    "has_descriptor": false,
                    "created_at": "2026-01-15T08:00:00Z",
                    "updated_at": "2026-06-01T10:00:00Z",
                    "discarded_at": "2026-06-01T10:00:00Z",
                    "discarded_by": "usr_01j1234567890abcdefghijk",
                    "discard_reason": "Superseded by ICD-11 catalogue"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/entries": {
      "get": {
        "operationId": "listCatalogueEntries",
        "x-bounded-list": true,
        "summary": "List bi-temporal entries",
        "description": "Returns one bounded page over authoritative PostgreSQL rows under normal\ntenant tenant-isolated, in one read-only repeatable-read snapshot. Both temporal axes\nare half-open; omitted instants use one captured request time.\nAttribute filters use independent `roles.filter.fields` permissions and\ndeclared types/matching modes. Missing or empty permissions deny; search\npermissions grant neither filtering nor sorting. Repeated, conflicting,\nunknown parameters and the retired `attr.<key>` filter grammar fail 400.\nString operands preserve empty strings and whitespace. Numeric comparisons\nare exact; booleans are `true`/`false`, dates Gregorian YYYY-MM-DD, enum\noperands canonical codes, typed IDs use the declared registered prefix.\nCurrency equality is a JSON object with exactly a known lowercase\ncurrency_code and an unquoted plain signed-int64 amount_minor; sorting\ncurrency values is unsupported. Invalid stored compared values fail the\ncomplete built-in cohort before attribute filtering or LIMIT.\nDescription search, exact code lookup and literal code-prefix lookup are\nseparate operations. Prefix and substring metacharacters are literal.\nOrdering defaults to code in C collation, logical entry ID, then row ID.\nExplicit attribute ordering uses declared types, present values followed\nby JSON null then missing values in both directions, with the same ties.\nNo partial or incorrectly sorted results are returned on exhaustion.\n`meta.page.has_more` describes truncation; this endpoint has no cursor or\nautomatic page traversal. Use history for cursor-based historical traversal.\n",
        "tags": [
          "Catalogue"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "description": "Real-world validity axis instant (RFC 3339). When provided, only\nentries whose `valid_from <= as_of < valid_to` (or `valid_to IS NULL`)\nare returned.\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "asserted_at",
            "in": "query",
            "required": false,
            "description": "Belief (assertion) axis instant (RFC 3339). When provided, only\nentries whose `asserted_from <= asserted_at < asserted_to` (or open asserted_to) are returned, enabling\nas-was reconstruction at a prior belief instant.\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "logical_entry_id",
            "in": "query",
            "required": false,
            "description": "Typed-prefix `cei_` logical entry ID; returns all bi-temporal versions for that entry within the requested temporal snapshot.",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "catalogue-logical-entry-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "description": "Exact code match filter.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "code_prefix",
            "in": "query",
            "required": false,
            "description": "Nonempty literal code prefix; mutually exclusive with exact code.",
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": false,
            "style": "deepObject",
            "explode": true,
            "description": "Typed scalar equality, AND across fields; keys are literal field names decoded once.",
            "schema": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            }
          },
          {
            "name": "is_null",
            "in": "query",
            "required": false,
            "style": "deepObject",
            "explode": true,
            "description": "Explicit JSON null; conflicts with another operation on the same field.",
            "schema": {
              "type": "object",
              "additionalProperties": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            }
          },
          {
            "name": "is_missing",
            "in": "query",
            "required": false,
            "style": "deepObject",
            "explode": true,
            "description": "Missing attribute (including SQL-null attributes); independent from JSON null.",
            "schema": {
              "type": "object",
              "additionalProperties": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Positive bounded page size; the required platform policy supplies default and maximum.",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Nonempty literal case-insensitive substring of the built-in description.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "required": false,
            "description": "Attribute sort field in the form `attr.<field>`. Only fields declared in\nthe catalogue descriptor `roles.sort.fields` are accepted (contract rule allow-list).\n",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dir",
            "in": "query",
            "required": false,
            "description": "Sort direction. One of `asc` or `desc`. Defaults to `asc`.",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Bi-temporal entries list",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalEntryListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "408": {
            "description": "CATALOGUE_QUERY_CANCELLED; caller cancelled the query, no partial success.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "CATALOGUE_QUERY_ADMISSION_EXHAUSTED; bounded shared admission refused.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "description": "CATALOGUE_QUERY_BUDGET_EXCEEDED or CATALOGUE_QUERY_UNAVAILABLE.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "504": {
            "description": "CATALOGUE_QUERY_DEADLINE_EXCEEDED; complete request budget exhausted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [
            "page[size]"
          ],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.page.limit",
            "meta.page.has_more"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "asserted_at",
            "logical_entry_id",
            "code",
            "code_prefix",
            "filter",
            "is_null",
            "is_missing",
            "q"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "published-429-response",
            "headers": [
              "Retry-After",
              "X-RateLimit-Limit",
              "X-RateLimit-Remaining",
              "X-RateLimit-Reset"
            ],
            "numeric_commitment": "tenant-policy-runtime",
            "limit_source": "active tenant rate_limit_policies.limit",
            "window_source": "active tenant rate_limit_policies.window_secs",
            "enforcement": "gateway-rate-limit-runtime"
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createCatalogueEntry",
        "summary": "Create bi-temporal entry",
        "description": "Appends a bi-temporal CatalogueEntry. Two modes:\n1. **New logical entry** \u2014 omit `logical_entry_id`; the server generates the logical identity.\n2. **New version of an existing logical entry** \u2014 supply the prior `logical_entry_id`\n   and a `valid_from` strictly later than the prior version's `valid_from`.\n\nReturns the created entry as a naked DTO (no `data` wrapper).\n\nRequires the `catalogue.write` capability (scope `catalogues:write`) from the caller's\ngrant in the operating tenant; no Keycloak realm role is required.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createBiTemporalEntryRequest"
              },
              "example": {
                "code": "J18.9",
                "description": "Pneumonia, unspecified organism",
                "valid_from": "2026-01-01T00:00:00Z"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Bi-temporal entry created (naked DTO, no data wrapper)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalEntryDTO"
                },
                "example": {
                  "id": "cae_01j1234567890abcdefghijk",
                  "logical_entry_id": "cei_01j1234567890abcdefghijk",
                  "catalogue_id": "cat_01j1234567890abcdefghijk",
                  "code": "J18.9",
                  "description": "Pneumonia, unspecified organism",
                  "status": "active",
                  "valid_from": "2026-01-01T00:00:00Z",
                  "recorded_at": "2026-01-15T08:00:00Z",
                  "asserted_from": "2026-01-15T08:00:00Z"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/entries/{logical_entry_id}/supersede": {
      "post": {
        "operationId": "supersedeCatalogueEntry",
        "summary": "Supersede bi-temporal entry",
        "description": "Closes the open-ended bi-temporal entry for the given `logical_entry_id`\nand inserts a successor in one transaction. The prior open version is\nidentified by `(tenant context, logical_entry_id, valid_to IS NULL,\nasserted_to IS NULL)`.\n\nThe successor inherits `catalogue_entity_id` and `code` from the prior\nversion; `description`, `status`, and `attributes` are optionally\noverridden via the request body.\n\nReturns the successor entry as a naked DTO (no `data` wrapper). The\nsuccessor response renders entity identifiers with the same typed-prefix\nwire forms as create and list responses.\n\nRequires the `catalogue.write` capability (scope `catalogues:write`) from the caller's\ngrant in the operating tenant; no Keycloak realm role is required.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/LogicalEntryIdPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/supersedeBiTemporalEntryRequest"
              },
              "example": {
                "new_valid_from": "2027-01-01T00:00:00Z",
                "new_description": "Pneumonia, unspecified organism (2027 revision)"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successor bi-temporal entry (naked DTO, no data wrapper)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalEntryDTO"
                },
                "example": {
                  "id": "cae_01j1234567890abcdefghijk",
                  "logical_entry_id": "cei_01j1234567890abcdefghijk",
                  "catalogue_id": "cat_01j1234567890abcdefghijk",
                  "code": "J18.9",
                  "description": "Pneumonia, unspecified organism (2027 revision)",
                  "status": "active",
                  "valid_from": "2027-01-01T00:00:00Z",
                  "recorded_at": "2027-01-15T08:00:00Z",
                  "source_provenance_id": "spv_01j1234567890abcdefghijk",
                  "asserted_from": "2027-01-15T08:00:00Z"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/entries/history": {
      "get": {
        "operationId": "listCatalogueEntryHistory",
        "summary": "Read the full bi-temporal history of one catalogue entry",
        "description": "Canonical full valid-time history read for one logical entry (governed contract). The entry-identity analogue of `temporal-values/history`: where that\nenumerates a temporal value's valid-time versions, this enumerates an\nENTRY's supersede chain (every valid-time version of one\n`logical_entry_id`), as currently believed (or, with `asserted_as_of`, as\nbelieved at that belief instant). Entries have no `value_type` axis, so the\nscan is bounded by `logical_entry_id` alone.\n\n`logical_entry_id` is REQUIRED to bound the scan (a history read is never an\nunbounded full-catalogue scan); omission \u2192 `400 CATALOGUE_HISTORY_SCAN_UNBOUNDED`.\nThere is deliberately no `as_of` param \u2014 valid-time is the axis being\nenumerated, not pinned to a point. Results are cursor-paginated and ordered\n`valid_from ASC, asserted_from ASC, entry_entity_id ASC`. `limit` defaults\nto 100 and is rejected with 400 above 1000 (not silently capped).\n`is_current` marks the version in force at wall-clock now within the\nselected belief set.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "name": "logical_entry_id",
            "in": "query",
            "required": true,
            "description": "Typed-prefix `cei_` logical entry ID (REQUIRED \u2014 scan-bounding).",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "catalogue-logical-entry-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "asserted_as_of",
            "in": "query",
            "required": false,
            "description": "Belief-axis instant (RFC 3339). Freezes the belief axis: the history is\nreturned as it was believed at this instant. Default = now (\"as\ncurrently believed\").\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "valid_from_gte",
            "in": "query",
            "required": false,
            "description": "Clip the valid-time scan to versions with `valid_from >=` this instant (RFC 3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "valid_from_lte",
            "in": "query",
            "required": false,
            "description": "Clip the valid-time scan to versions with `valid_from <=` this instant (RFC 3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Page size (default 100, hard cap 1000).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from a prior response's `meta.next_cursor`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Full bi-temporal history page for one catalogue entry",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalEntryHistoryListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "logical_entry_id",
            "asserted_as_of",
            "valid_from_gte",
            "valid_from_lte"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/temporal-values/history": {
      "get": {
        "operationId": "listCatalogueTemporalValueHistory",
        "summary": "Read the full bi-temporal history of one temporal value",
        "description": "Canonical full valid-time history read (governed contract, \u00a7update 2026-06-05).\n\nUnlike `GET .../temporal-values` \u2014 a point-in-time as-was reader that\nreturns at most one value per `(logical_entry_id, value_type)` in force at\n`as_of` \u2014 this sub-resource **enumerates the valid-time axis** (every\nversion) for ONE `(logical_entry_id, value_type)`, as currently believed\n(or, with `asserted_as_of`, as believed at that belief instant). It is a\ndistinct surface, never a mode flag on the point-in-time reader.\n\n`logical_entry_id` + `value_type` are REQUIRED to bound the scan (a history\nread is never an unbounded full-catalogue scan); omission \u2192\n`400 CATALOGUE_HISTORY_SCAN_UNBOUNDED`. There is deliberately no `as_of`\nparam \u2014 valid-time is the axis being enumerated, not pinned to a point.\nResults are cursor-paginated and ordered\n`valid_from ASC, asserted_from ASC, temporal_value_entity_id ASC`.\n`limit` defaults to 100 and is rejected with 400 above 1000 (not silently\ncapped). `is_current` marks the version in force at wall-clock now within\nthe selected belief set.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "name": "logical_entry_id",
            "in": "query",
            "required": true,
            "description": "Typed-prefix `cei_` parent logical entry ID (REQUIRED \u2014 scan-bounding).",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "catalogue-logical-entry-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "value_type",
            "in": "query",
            "required": true,
            "description": "Exact value_type discriminator (REQUIRED \u2014 scan-bounding), e.g. `gems_tariff_amount`, `sep_price`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "asserted_as_of",
            "in": "query",
            "required": false,
            "description": "Belief-axis instant (RFC 3339). Freezes the belief axis: the history is\nreturned as it was believed at this instant. Default = now (\"as\ncurrently believed\").\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "valid_from_gte",
            "in": "query",
            "required": false,
            "description": "Clip the valid-time scan to versions with `valid_from >=` this instant (RFC 3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "valid_from_lte",
            "in": "query",
            "required": false,
            "description": "Clip the valid-time scan to versions with `valid_from <=` this instant (RFC 3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Page size (default 100, hard cap 1000).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from a prior response's `meta.next_cursor`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Full bi-temporal history page for one temporal value",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalTVHistoryListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "logical_entry_id",
            "value_type",
            "asserted_as_of",
            "valid_from_gte",
            "valid_from_lte"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/temporal-values/belief-walk": {
      "get": {
        "operationId": "beliefWalkCatalogueTemporalValues",
        "summary": "Walk the belief (assertion) axis of one temporal value at a fixed instant",
        "description": "The dual of `temporal-values/history` (governed contract, \u00a7update 2026-06-06).\n\nWhere `history` pins the belief axis and enumerates the valid-time axis,\nthe belief-walk pins the valid-time axis to a fixed real-world instant\n(`valid_at`) and **enumerates the belief (assertion) axis**: \"how did our\nbelief about the value in force at `valid_at` change over time?\". Each row\nis a belief window (`asserted_from` / `asserted_to`) that covered the value\nin force at `valid_at`.\n\n`logical_entry_id` + `value_type` are REQUIRED to bound the scan; omission \u2192\n`400 CATALOGUE_BELIEF_WALK_SCAN_UNBOUNDED`. `valid_at` (RFC 3339) is REQUIRED\nand has a DISTINCT typed error on omission \u2192 `400 CATALOGUE_BELIEF_WALK_MISSING_VALID_AT`\n(it is the fixed real-world instant, not a scan bound). Results are\ncursor-paginated and ordered `asserted_from ASC, temporal_value_entity_id ASC`\n(a 2-field cursor \u2014 valid-time is fixed, so it carries no ordering info).\n`limit` defaults to 100 and is rejected with 400 above 1000 (not silently\ncapped). `is_current` = `asserted_to IS NULL` \u2014 the currently-open belief\nfor the fixed `valid_at` (at most one row true; none after full retraction).\nA `valid_at` outside every validity window returns an empty page (not an\nerror). Reuses the `biTemporalTVHistoryDTO` row shape (all five governed contract axes).\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "name": "logical_entry_id",
            "in": "query",
            "required": true,
            "description": "Typed-prefix `cei_` parent logical entry ID (REQUIRED \u2014 scan-bounding).",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "catalogue-logical-entry-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "value_type",
            "in": "query",
            "required": true,
            "description": "Exact value_type discriminator (REQUIRED \u2014 scan-bounding), e.g. `gems_tariff_amount`, `sep_price`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "valid_at",
            "in": "query",
            "required": true,
            "description": "The fixed real-world instant (RFC 3339) to walk the belief axis at\n(REQUIRED). The belief windows returned are those that covered the\nvalue whose validity contained this instant. Distinct typed error on\nomission (`CATALOGUE_BELIEF_WALK_MISSING_VALID_AT`).\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "asserted_from_gte",
            "in": "query",
            "required": false,
            "description": "Clip the belief-axis scan to windows with `asserted_from >=` this instant (RFC 3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "asserted_from_lte",
            "in": "query",
            "required": false,
            "description": "Clip the belief-axis scan to windows with `asserted_from <=` this instant (RFC 3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Page size (default 100, hard cap 1000).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from a prior response's `meta.next_cursor`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Belief-axis page for the value in force at valid_at",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalTVHistoryListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "logical_entry_id",
            "value_type",
            "valid_at",
            "asserted_from_gte",
            "asserted_from_lte"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/temporal-values": {
      "get": {
        "operationId": "listCatalogueTemporalValues",
        "summary": "List bi-temporal temporal values",
        "description": "Returns bi-temporal temporal values for the given catalogue, filtered\nby the two-axis as-was window (`as_of` / `asserted_at`) and optional\nattribute filters.\n\nOptional filters:\n- `logical_entry_id` \u2014 return all versions of a single `cei_` logical entry.\n- `value_type` \u2014 exact value_type discriminator match.\n- `code` \u2014 exact code match on the parent entry.\n- `limit` \u2014 integer page size.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "description": "Real-world validity axis instant (RFC 3339). When provided, only\ntemporal values whose `valid_from <= as_of < valid_to` (or `valid_to IS NULL`)\nare returned.\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "asserted_at",
            "in": "query",
            "required": false,
            "description": "Belief-axis instant (RFC 3339). Selects the assertion window\nasserted_from <= asserted_at < asserted_to, with an open end allowed.\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "logical_entry_id",
            "in": "query",
            "required": false,
            "description": "Typed-prefix `cei_` parent logical entry ID; returns all temporal values for that entry.",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "catalogue-logical-entry-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "value_type",
            "in": "query",
            "required": false,
            "description": "Exact value_type discriminator match (e.g. `sep_price`, `list_price`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "description": "Exact code match on the parent catalogue entry.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Bi-temporal temporal values list",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalTVListResponse"
                },
                "example": {
                  "temporal_values": [
                    {
                      "id": "tmv_01j1234567890abcdefghijk",
                      "logical_entry_id": "cei_01j1234567890abcdefghijk",
                      "catalogue_id": "cat_01j1234567890abcdefghijk",
                      "value_type": "sep_price",
                      "value": {
                        "amount": "267.00",
                        "currency_code": "zar"
                      },
                      "valid_from": "2026-01-01T00:00:00Z",
                      "recorded_at": "2026-01-15T08:00:00Z"
                    }
                  ],
                  "count": 1
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "asserted_at",
            "logical_entry_id",
            "value_type",
            "code"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createCatalogueTemporalValue",
        "summary": "Create bi-temporal temporal value",
        "description": "Appends a bi-temporal temporal value for a catalogue entry. The\n`logical_entry_id` identifies the parent entry. `value_type` and `value`\ndefine the typed payload (e.g. `sep_price` with `{\"amount\":\"267.00\",\n\"currency_code\":\"zar\"}`).\n\nReturns the created temporal value as a naked DTO (no `data` wrapper).\n\nRequires the `catalogue.write` capability (scope `catalogues:write`) from the caller's\ngrant in the operating tenant; no Keycloak realm role is required.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createBiTemporalTVRequest"
              },
              "example": {
                "logical_entry_id": "cei_01j1234567890abcdefghijk",
                "code": "sep_price",
                "value_type": "money",
                "value": {
                  "amount": "267.00",
                  "currency_code": "zar"
                },
                "valid_from": "2026-01-01T00:00:00Z"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Bi-temporal temporal value created (naked DTO, no data wrapper)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalTVDTO"
                },
                "example": {
                  "id": "tmv_01j1234567890abcdefghijk",
                  "logical_entry_id": "cei_01j1234567890abcdefghijk",
                  "catalogue_id": "cat_01j1234567890abcdefghijk",
                  "value_type": "sep_price",
                  "value": {
                    "amount": "267.00",
                    "currency_code": "zar"
                  },
                  "valid_from": "2026-01-01T00:00:00Z",
                  "recorded_at": "2026-01-15T08:00:00Z"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/relationships": {
      "get": {
        "operationId": "listCatalogueRelationshipsBiTemporal",
        "summary": "List bi-temporal relationships",
        "description": "Returns bi-temporal catalogue relationships for the given catalogue,\nfiltered by the two-axis as-was window and optional source/target\nentry filters.\n\nOptional filters:\n- `source_catalogue` \u2014 `cat_` ID of the source catalogue.\n- `source_logical_entry_id` \u2014 `cei_` ID of the source logical entry.\n- `target_catalogue` \u2014 `cat_` ID of the target catalogue.\n- `target_logical_entry_id` \u2014 `cei_` ID of the target logical entry.\n- `relationship_type` \u2014 `crp_` ID of the relationship-type catalogue entry.\n- `limit` \u2014 integer page size.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "description": "Real-world validity axis instant (RFC 3339). When provided, only\nrelationships whose `valid_from <= as_of < valid_to` (or `valid_to IS NULL`)\nare returned.\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "asserted_at",
            "in": "query",
            "required": false,
            "description": "Belief-axis instant (RFC 3339). Selects the assertion window\nasserted_from <= asserted_at < asserted_to, with an open end allowed.\n",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "source_catalogue",
            "in": "query",
            "required": false,
            "description": "Typed-prefix `cat_` source catalogue ID to filter relationships by.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source_logical_entry_id",
            "in": "query",
            "required": false,
            "description": "Typed-prefix `cei_` source logical entry ID to filter relationships by.",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "opaque-resource-id",
              "x-axiom-identifier-shape": "alpha-exception",
              "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
            }
          },
          {
            "name": "target_catalogue",
            "in": "query",
            "required": false,
            "description": "Typed-prefix `cat_` target catalogue ID to filter relationships by.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "target_logical_entry_id",
            "in": "query",
            "required": false,
            "description": "Typed-prefix `cei_` target logical entry ID to filter relationships by.",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "opaque-resource-id",
              "x-axiom-identifier-shape": "alpha-exception",
              "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
            }
          },
          {
            "name": "relationship_type",
            "in": "query",
            "required": false,
            "description": "Typed-prefix `crp_` relationship-type catalogue entry ID to filter by.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Bi-temporal relationships list",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalRelationshipListResponse",
                  "example": {
                    "relationships": [
                      {
                        "id": "car_01j1234567890abcdefghijk",
                        "logical_relationship_id": "car_01j1234567890abcdefghijkl",
                        "source_catalogue_entity_id": "cat_01j1234567890abcdefghijk",
                        "source_logical_entry_id": "cei_01j1234567890abcdefghijk",
                        "target_catalogue_entity_id": "cat_01j9876543210abcdefghijk",
                        "target_logical_entry_id": "cei_01j1234567890abcdefghijk",
                        "relationship_type_entity_id": "crp_01j1234567890abcdefghijk",
                        "valid_from": "2026-01-01T00:00:00Z",
                        "recorded_at": "2026-01-15T08:00:00Z"
                      }
                    ]
                  },
                  "count": 1
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "asserted_at",
            "source_catalogue",
            "source_logical_entry_id",
            "target_catalogue",
            "target_logical_entry_id",
            "relationship_type"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createCatalogueRelationshipBiTemporal",
        "summary": "Create bi-temporal relationship",
        "description": "Creates a bi-temporal relationship between two catalogue entries. If\n`logical_relationship_id` is omitted the server generates the logical relationship identity.\nThe relationship spans from `valid_from` until superseded.\n\nReturns the created relationship as a naked DTO (no `data` wrapper).\n\nRequires the `catalogue.write` capability (scope `catalogues:write`) from the caller's\ngrant in the operating tenant; no Keycloak realm role is required.\n\nNote: batch relationship creation lives at\n`/v1/catalogues/{catalogue-ref}/relationships/batch` (a separate path item\nunder the same `catalogue.write` capability).\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createBiTemporalRelationshipRequest",
                "example": {
                  "logical_relationship_id": "car_01j1234567890abcdefghijkl",
                  "relationship_type_entity_id": "crp_01j1234567890abcdefghijk",
                  "source_catalogue_entity_id": "cat_01j1234567890abcdefghijk",
                  "source_logical_entry_id": "cei_01j1234567890abcdefghijk",
                  "source_code": "N000123",
                  "target_catalogue_entity_id": "cat_01j9876543210abcdefghijk",
                  "target_logical_entry_id": "cei_01j1234567890abcdefghijk",
                  "target_code": "ATC-J01CA04",
                  "valid_from": "2026-01-01T00:00:00Z"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Bi-temporal relationship created (naked DTO, no data wrapper)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/biTemporalRelationshipDTO",
                  "example": {
                    "id": "car_01j1234567890abcdefghijk",
                    "logical_relationship_id": "car_01j1234567890abcdefghijkl",
                    "source_catalogue_entity_id": "cat_01j1234567890abcdefghijk",
                    "source_logical_entry_id": "cei_01j1234567890abcdefghijk",
                    "target_catalogue_entity_id": "cat_01j9876543210abcdefghijk",
                    "target_logical_entry_id": "cei_01j1234567890abcdefghijk",
                    "relationship_type_entity_id": "crp_01j1234567890abcdefghijk",
                    "valid_from": "2026-01-01T00:00:00Z",
                    "recorded_at": "2026-01-15T08:00:00Z"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/labels": {
      "post": {
        "operationId": "stampCatalogueLabel",
        "summary": "Stamp a label on a catalogue",
        "description": "Stamps a named label on a catalogue. Labels are used to mark specific\ncatalogue versions for reference. Returns 409 if a label with the same\nname already exists.\n\nruntime source stampCatalogueLabelHandler returns 201 Created with\na naked catalogueLabelDTO (no {data:...} wrapper).\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/stampLabelRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Label stamped successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/catalogueLabelDTO"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Not found. Also the deny response when the caller's grant lacks the route capability (governed contract Decision 1).",
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listCatalogueLabels",
        "summary": "List labels on a catalogue",
        "description": "Returns all labels stamped on the given catalogue.\nruntime source listCatalogueLabelsHandler returns 200 with\na {labels:[...],count:N} envelope.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "responses": {
          "200": {
            "description": "Label list returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/catalogueLabelListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/descriptor": {
      "put": {
        "operationId": "upsertCatalogueDescriptor",
        "summary": "Upsert a descriptor for a catalogue",
        "description": "Creates or replaces the descriptor for a catalogue. Returns 200 for\nboth create and update (upsert semantics).\nruntime source putCatalogueDescriptorHandler returns 200 OK\nwith a naked descriptorDTO (no {data:...} wrapper).\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/upsertDescriptorRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Descriptor upserted successfully.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/descriptorDTO"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Not found. Also the deny response when the caller's grant lacks the route capability (governed contract Decision 1).",
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "getCatalogueDescriptor",
        "summary": "Get the descriptor for a catalogue",
        "description": "Returns the descriptor for the given catalogue. Returns 404 if no\ndescriptor has been set.\nruntime source getCatalogueDescriptorHandler returns 200 OK\nwith a naked descriptorDTO (no {data:...} wrapper).\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "responses": {
          "200": {
            "description": "Descriptor returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/descriptorDTO"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/sources/{source_id}": {
      "get": {
        "operationId": "getCatalogueSourceProvenance",
        "summary": "Get source provenance detail for a catalogue load",
        "description": "Returns detailed source provenance for a specific catalogue load run,\nincluding entry counts, field checksums, and load metadata.\nruntime source getSourceProvenanceHandler returns 200 OK\nwith a {data: sourceProvenanceDTO} envelope.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          },
          {
            "name": "source_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "opaque-resource-id",
              "x-axiom-identifier-shape": "alpha-exception",
              "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
            },
            "description": "Typed-prefix `spv_` source-provenance load record ID.",
            "example": "spv_01j1234567890abcdefghijk"
          }
        ],
        "responses": {
          "200": {
            "description": "Source provenance detail returned.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/sourceProvenanceDTO"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/bulk-write": {
      "post": {
        "operationId": "bulkWriteCatalogueEntries",
        "summary": "Submit a bulk-write job for a catalogue",
        "description": "Enqueues an async catalogue ingestion job from a previously-uploaded file.\nReturns 202 Accepted immediately; the job runs asynchronously.\nruntime source catalogueBulkWriteHandler returns 202 Accepted\nwith a catalogueBulkWriteResponse containing the job_id.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:bulk-write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRefPath"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/catalogueBulkWriteRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Bulk-write job accepted and queued.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/catalogueBulkWriteResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request. Error codes include SCHEMA_VERSION_UNSUPPORTED.",
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "description": "Forbidden. Error codes include UPLOAD_ID_TENANT_MISMATCH.",
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Not found. Also the deny response when the caller's grant lacks the route capability (governed contract Decision 1).",
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:bulk-write"
          ],
          "required_permissions": [
            "catalogues:bulk-write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/catalogues/{catalogue-ref}/relationships/batch": {
      "post": {
        "operationId": "createCatalogueRelationshipBatch",
        "summary": "Atomically create N relationships in one transaction",
        "description": "Atomic batch create under the governed contract. Either every row in the\n`relationships` array is persisted, or none are. The path\n:catalogue-ref scopes the batch \u2014 every row's source_catalogue MUST\nequal the path. Unlike the single-create endpoint, source fields are\nNOT defaulted from the path; each row must specify them explicitly.\nMaximum batch size is 10000 (BATCH_SIZE_EXCEEDED 400 above that).\nRequires the `catalogue.write` capability (scope `catalogues:write`)\nfrom the caller's grant in the operating tenant.\n",
        "tags": [
          "Catalogue"
        ],
        "security": [
          {
            "BearerAuth": [
              "catalogues:write"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader"
          },
          {
            "$ref": "#/components/parameters/CatalogueRelationshipRefPath"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "relationships"
                ],
                "properties": {
                  "relationships": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 10000,
                    "items": {
                      "$ref": "#/components/schemas/CatalogueRelationshipBody"
                    }
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "All relationships created atomically.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "required": [
                        "relationships",
                        "count"
                      ],
                      "properties": {
                        "count": {
                          "type": "integer",
                          "minimum": 0
                        },
                        "relationships": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/CatalogueRelationship"
                          }
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "catalogues:write"
          ],
          "required_permissions": [
            "catalogues:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups": {
      "get": {
        "operationId": "listPartyGroups",
        "summary": "List party groups",
        "description": "Returns party groups for the tenant with cursor pagination. Results are\nordered by created_at descending with id as a stable tiebreaker. Supports\na free-text search via `q` (3-character minimum under the governed contract).\n",
        "tags": [
          "Party Group"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of party groups to return in this cursor page."
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor returned as `meta.next_cursor` by the previous page."
          },
          {
            "name": "q",
            "in": "query",
            "description": "Search across display_name, id, external_id (min 3 chars, governed contract)",
            "schema": {
              "type": "string",
              "minLength": 3
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Party group list",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "q"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createPartyGroup",
        "summary": "Create a party group",
        "description": "Creates a static or dynamic party group. For dynamic groups,\n`membership_rule_id` is required and must reference a rule of type\n`party_grouping` in the shared rules catalog (fail-loud; 400 on\ninvalid reference). Idempotent via standard Idempotency-Key header.\n",
        "tags": [
          "Party Group"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePartyGroupRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "getPartyGroup",
        "summary": "Get a party group with its active members",
        "description": "Returns the group and its active memberships as of `as_of` (defaults\nto now). Members include both party-type and group-type (developer preview\npolymorphic DAG) \u2014 callers must discriminate on `member_type`.\n",
        "tags": [
          "Party Group"
        ],
        "parameters": [
          {
            "name": "as_of",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Group + members",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupDetailResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "put": {
        "operationId": "updatePartyGroup",
        "summary": "Update display_name / description / status",
        "description": "Partial update \u2014 only supplied fields are changed. Soft-delete is\nachieved via setting status to `inactive` here OR calling DELETE.\n",
        "tags": [
          "Party Group"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdatePartyGroupRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "delete": {
        "operationId": "deletePartyGroup",
        "summary": "Soft delete (status \u2192 inactive)",
        "description": "Soft-delete \u2014 flips status to `inactive`. The group row and its\nmemberships are preserved for audit under the governed contract. There is no hard\ndelete.\n",
        "tags": [
          "Party Group"
        ],
        "responses": {
          "204": {
            "description": "Deleted (soft)"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/members": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "post": {
        "operationId": "addPartyGroupMember",
        "summary": "Add a party or group as a member",
        "description": "Body must supply exactly one of `party_id` or `group_id`. Neither or\nboth \u2192 400. Cycle detection happens at read time (bounded traversal, governed contract) \u2014 writes do not block cyclic membership.\nIdempotent on (group, member_type, member_id) when a membership is\nalready open.\n",
        "tags": [
          "Party Group"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddPartyGroupMemberRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Member added",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupMembershipResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/members/{partyId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        {
          "name": "partyId",
          "in": "path",
          "required": true,
          "description": "Member id. The path parameter is named `partyId` for legacy reasons;\nthe endpoint accepts both party-member-ids and group-member-ids\n(developer preview \u2014 any member_id regardless of type).\n",
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "pty_01arz3ndektsv4rrffq69g5fav"
          }
        }
      ],
      "delete": {
        "operationId": "removePartyGroupMember",
        "summary": "Close a member's open window (sets valid_to = now)",
        "description": "Idempotent \u2014 if no open membership exists, returns 204 without error.\nDoes not hard-delete the membership row; the closed window is\npreserved for audit (governed contract).\n",
        "tags": [
          "Party Group"
        ],
        "responses": {
          "204": {
            "description": "Membership closed (or no-op if already closed)"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/flat-members": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "listPartyGroupFlatMembers",
        "summary": "List all party members reachable via recursive expansion",
        "description": "Recursively walks the membership DAG and returns every party that is\nreachable \u2014 de-duplicated by party_id. Uses bounded traversal with a\ncycle guard (governed contract): diamonds are de-duped, cycles are\nshort-circuited.\n",
        "tags": [
          "Party Group"
        ],
        "parameters": [
          {
            "name": "as_of",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "max_depth",
            "in": "query",
            "description": "BFS depth cap [1, 16]. Server returns 400 for out-of-range. 0 or omitted \u2192 default (4).",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 16
            }
          }
        ],
        "responses": {
          "200": {
            "description": "De-duplicated flat member list with paths",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupFlatMemberListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "max_depth"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/ancestors": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "listPartyGroupAncestors",
        "summary": "List groups that transitively contain this group",
        "description": "BFS upward through the membership DAG up to `max_depth`.",
        "tags": [
          "Party Group"
        ],
        "parameters": [
          {
            "name": "as_of",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "max_depth",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 16
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ancestor groups",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "max_depth"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/descendants": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "listPartyGroupDescendants",
        "summary": "List groups transitively contained by this group",
        "description": "BFS downward through the membership DAG up to `max_depth`.",
        "tags": [
          "Party Group"
        ],
        "parameters": [
          {
            "name": "as_of",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "max_depth",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 16
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Descendant groups",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "max_depth"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/evaluate": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "post": {
        "operationId": "evaluatePartyGroupMembership",
        "summary": "Dry-run evaluate a party against a dynamic group's rule",
        "description": "Read-only evaluation \u2014 calls the membership-rule evaluator and\nreturns `is_member` plus an explanation summary. Does NOT persist\nmembership. Only valid for `group_type = dynamic`; static groups\nreturn 400. Classification: `intentional_exception` in the\npost-route manifest (POST that doesn't mutate).\n",
        "tags": [
          "Party Group"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvaluatePartyGroupRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Evaluation result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupEvaluationResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/roles": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "listPartyGroupRoles",
        "summary": "List roles held directly by this group",
        "description": "Returns roles where this group is the assignee (`assignee_type =\ngroup`). under the governed contract there is NO automatic inheritance \u2014\nthese roles do not flow to member parties.\n",
        "tags": [
          "Party Group"
        ],
        "responses": {
          "200": {
            "description": "Roles held by the group",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupRoleListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "assignPartyGroupRole",
        "summary": "Assign a role to the group",
        "description": "Assigns a role with the group as assignee. Idempotent via\nIdempotency-Key.\n\nFor role_type=accepted_provider_network:\n- Assignee group must have composition_type=provider_network \u2192 422 INVALID_ASSIGNMENT otherwise.\n- Context entity_type must be product \u2192 context entity_id must reference an\n  existing product in the tenant \u2192 404 PRODUCT_CONTEXT_NOT_FOUND if missing.\n- Overlapping active windows on the same (group, role_type, product) tuple\n  return 409 NETWORK_ROLE_ALREADY_ACTIVE.\n",
        "tags": [
          "Party Group"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssignGroupRoleRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Role assigned",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyGroupRoleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/roles/{roleId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/TenantIdHeader"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        {
          "name": "roleId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "plg_01arz3ndektsv4rrffq69g5fav"
          }
        }
      ],
      "delete": {
        "operationId": "revokePartyGroupRole",
        "summary": "Revoke a role held by the group",
        "description": "Closes the role assignment with an optional reason supplied as a\nJSON body `{reason: \"...\"}`.\n",
        "tags": [
          "Party Group"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Role revoked"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers": {
      "post": {
        "operationId": "createProduct",
        "summary": "Create a new insurance product",
        "description": "Create a product definition in the catalogue. Products define the coverage template\nfrom which policies are issued. A product includes coverage sections (covers),\nconfigurable terms, pricing rules, and commission structures.\n\nProducts are created in \"draft\" status and must be explicitly activated before\npolicies can be issued against them.\n",
        "tags": [
          "Product"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProductRequest"
              },
              "examples": {
                "motor_tpl": {
                  "summary": "Motor third-party liability product (UK)",
                  "value": {
                    "product_code": "MOTOR-TPL-2026",
                    "name": "Motor Third-Party Liability",
                    "type": "motor",
                    "description": "Mandatory third-party liability cover for motor vehicles registered in the United Kingdom",
                    "currency": "gbp",
                    "attributes": {
                      "base_premium": 120000,
                      "region": "UK",
                      "regulatory_class": "compulsory",
                      "minimum_age": 17
                    },
                    "covers": [
                      {
                        "code": "TPL-BODILY",
                        "name": "Third-Party Bodily Injury",
                        "description": "Covers liability for bodily injury to third parties arising from vehicle use",
                        "type": "basic",
                        "sum_insured": 1000000,
                        "deductible": 0
                      },
                      {
                        "code": "TPL-PROPERTY",
                        "name": "Third-Party Property Damage",
                        "description": "Covers liability for damage to third-party property",
                        "type": "basic",
                        "sum_insured": 250000,
                        "deductible": 500
                      }
                    ],
                    "terms": [
                      {
                        "code": "POLICY-DURATION",
                        "name": "Policy Duration",
                        "data_type": "integer",
                        "required": true
                      }
                    ]
                  }
                },
                "health_comprehensive": {
                  "summary": "Comprehensive health cover",
                  "value": {
                    "product_code": "HEALTH-COMP-2026",
                    "name": "Comprehensive Health Cover",
                    "type": "health",
                    "description": "Comprehensive health plan covering inpatient, outpatient, dental, and optical care",
                    "currency": "usd",
                    "attributes": {
                      "base_premium": 250000,
                      "scheme_type": "open",
                      "regulatory_registration": "HIC-2026-001"
                    },
                    "covers": [
                      {
                        "code": "INPATIENT",
                        "name": "Inpatient Hospital Cover",
                        "description": "Covers hospitalisation, surgery, and ICU stays",
                        "type": "basic",
                        "sum_insured": 5000000,
                        "deductible": 0
                      },
                      {
                        "code": "DENTAL",
                        "name": "Dental Cover",
                        "description": "Covers dental consultations, fillings, and extractions",
                        "type": "optional",
                        "sum_insured": 25000,
                        "deductible": 500
                      }
                    ],
                    "terms": [
                      {
                        "code": "WAITING-PERIOD-DAYS",
                        "name": "Waiting Period",
                        "data_type": "integer",
                        "required": true
                      }
                    ]
                  }
                },
                "property_commercial": {
                  "summary": "Commercial property insurance (Brazil)",
                  "value": {
                    "product_code": "PROP-COMM-2026",
                    "name": "Seguro Empresarial",
                    "type": "property",
                    "description": "Commercial property insurance covering fire, theft, natural disasters, and business interruption",
                    "currency": "brl",
                    "attributes": {
                      "base_premium": 500000,
                      "market": "LATAM",
                      "susep_code": "0114"
                    },
                    "covers": [
                      {
                        "code": "FIRE",
                        "name": "Fire Cover",
                        "description": "Covers damage caused by fire",
                        "type": "basic",
                        "sum_insured": 10000000,
                        "deductible": 5000
                      }
                    ],
                    "terms": [
                      {
                        "code": "CONSTRUCTION-TYPE",
                        "name": "Construction Type",
                        "data_type": "string",
                        "required": true
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Product created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                },
                "examples": {
                  "motor_created": {
                    "summary": "Motor product created in draft status",
                    "value": {
                      "data": {
                        "id": "prd_3f8a9c1e2b7d4f60",
                        "product_code": "MOTOR-TPL-2026",
                        "name": "Motor Third-Party Liability",
                        "type": "motor",
                        "status": "draft",
                        "description": "Mandatory third-party liability cover for motor vehicles registered in the United Kingdom",
                        "currency": "gbp",
                        "attributes": {
                          "base_premium": 120000,
                          "region": "UK",
                          "regulatory_class": "compulsory",
                          "minimum_age": 17
                        },
                        "covers": [
                          {
                            "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                            "code": "TPL-BODILY",
                            "name": "Third-Party Bodily Injury",
                            "type": "basic",
                            "sum_insured": 1000000,
                            "deductible": 0,
                            "status": "active"
                          },
                          {
                            "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                            "code": "TPL-PROPERTY",
                            "name": "Third-Party Property Damage",
                            "type": "basic",
                            "sum_insured": 250000,
                            "deductible": 500,
                            "status": "active"
                          }
                        ],
                        "terms": [
                          {
                            "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                            "code": "POLICY-DURATION",
                            "name": "Policy Duration",
                            "data_type": "integer",
                            "required": true
                          }
                        ],
                        "created_at": "2026-03-12T08:00:00Z",
                        "updated_at": "2026-03-12T08:00:00Z"
                      },
                      "status": "success",
                      "message": "Product created successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/{id}": {
      "put": {
        "operationId": "updateProduct",
        "summary": "Update a product",
        "description": "Update an existing product's metadata, attributes, or status.\nProducts can be transitioned from \"draft\" to \"active\" status via this endpoint.\n\nUpdating an active product creates a new version. Existing policies issued under\nprevious versions are not affected.\n",
        "tags": [
          "Product"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductRequest"
              },
              "examples": {
                "activate_product": {
                  "summary": "Activate a draft product",
                  "value": {
                    "status": "active"
                  }
                },
                "update_metadata": {
                  "summary": "Update product description and attributes",
                  "value": {
                    "description": "Enhanced motor third-party liability with increased bodily injury limits",
                    "attributes": {
                      "max_vehicle_age_years": 15,
                      "minimum_age": 18
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Product updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                },
                "examples": {
                  "activated": {
                    "summary": "Product activated",
                    "value": {
                      "data": {
                        "id": "prd_3f8a9c1e2b7d4f60",
                        "product_code": "MOTOR-TPL-2026",
                        "name": "Motor Third-Party Liability",
                        "type": "motor",
                        "status": "active",
                        "description": "Mandatory third-party liability cover for motor vehicles",
                        "currency": "gbp",
                        "created_at": "2026-03-12T08:00:00Z",
                        "updated_at": "2026-03-12T10:00:00Z"
                      },
                      "status": "success",
                      "message": "Product updated successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/covers": {
      "get": {
        "operationId": "listCovers",
        "summary": "List current Covers",
        "description": "Query tenant-owned protection promises directly, with both valid and\nasserted windows open. Order is logical Cover identity ascending.\nContinuations bind tenant, resource, normalised q, ordering and current\ngeneration mode. Every page reapplies authority and tenant predicates;\ntokens are positions, not grants. Pages are not a frozen export.\nRetired limit/offset pagination and incompatible cursors are rejected.\n",
        "tags": [
          "Product"
        ],
        "security": [
          {
            "BearerAuth": [
              "covers:read"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "page[size]",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Opaque continuation from meta.next_cursor."
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Literal case-insensitive substring of name or code; trims outer whitespace and lowercases, preserving internal whitespace."
          }
        ],
        "responses": {
          "200": {
            "description": "Current Cover summaries with continuation metadata",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CoverSummaryListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "q"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:read"
          ],
          "required_permissions": [
            "covers:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/covers/{id}": {
      "get": {
        "operationId": "getCover",
        "summary": "Inspect a current Cover",
        "description": "Read one tenant-owned logical Cover and its complete protection graph\nunder a coherent tenant read snapshot. This is a current offering read,\nnot an as-bound policy view. Includes the owning Product identity, Cover\nterms and item terms. Independent addressability does not imply shared\nreuse or independent authoring. Unknown or foreign identities are masked\nas not found; malformed or wrong-kind identities are invalid requests.\n",
        "tags": [
          "Product"
        ],
        "security": [
          {
            "BearerAuth": [
              "covers:read"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^cov_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Logical Cover identity, never a stored revision row identity."
          }
        ],
        "responses": {
          "200": {
            "description": "Complete current protection promise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CoverResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:read"
          ],
          "required_permissions": [
            "covers:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/products": {
      "get": {
        "operationId": "listProducts",
        "summary": "List products",
        "description": "Retrieve current Product masters (valid_to is open), ordered by\nrecorded_at descending then identity ascending. Each continuation is bound\nto tenant, resource, normalised q, ordering and current-master mode.\nPages are current reads, not a frozen multi-request export. Old unscoped\ncursors and limit/offset are rejected. Both draft and active Products may appear.\n",
        "tags": [
          "Product"
        ],
        "security": [
          {
            "BearerAuth": [
              "covers:read"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of products to return in this cursor page"
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque product cursor from the previous response meta.next_cursor"
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Literal case-insensitive substring of name or product_code; trims outer whitespace and lowercases, preserving internal whitespace."
          }
        ],
        "responses": {
          "200": {
            "description": "Products retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductListResponse"
                },
                "examples": {
                  "product_list": {
                    "summary": "Mixed product types",
                    "value": {
                      "data": [
                        {
                          "id": "prd_3f8a9c1e2b7d4f60",
                          "product_code": "MOTOR-TPL-2026",
                          "name": "Motor Third-Party Liability",
                          "type": "motor",
                          "status": "active",
                          "description": "Mandatory third-party liability cover for motor vehicles",
                          "currency": "gbp",
                          "created_at": "2026-03-12T08:00:00Z",
                          "updated_at": "2026-03-12T08:00:00Z"
                        },
                        {
                          "id": "prd_01abcdefghjkmnpqrstvwxyz02",
                          "product_code": "HEALTH-COMP-2026",
                          "name": "Comprehensive Health Cover",
                          "type": "health",
                          "status": "active",
                          "description": "Comprehensive health plan covering inpatient, outpatient, dental, and optical care",
                          "currency": "usd",
                          "created_at": "2026-03-11T14:00:00Z",
                          "updated_at": "2026-03-11T14:00:00Z"
                        },
                        {
                          "id": "prd_01abcdefghjkmnpqrstvwxyz03",
                          "product_code": "LIFE-TERM-2026",
                          "name": "Term Life Assurance",
                          "type": "life",
                          "status": "draft",
                          "description": "Fixed-term life assurance with lump sum death benefit",
                          "currency": "usd",
                          "created_at": "2026-03-10T09:00:00Z",
                          "updated_at": "2026-03-10T09:00:00Z"
                        }
                      ],
                      "meta": {
                        "page_size": 20,
                        "has_more": false
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "q"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:read"
          ],
          "required_permissions": [
            "covers:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/products/{id}": {
      "get": {
        "operationId": "getProduct",
        "summary": "Get a product by ID",
        "description": "Retrieve a current Product with its full configuration including Covers,\nterms, pricing rules, and commission structures under one coherent tenant\nread snapshot. This is the current offering, not a bound policy view.\nUnknown or foreign identities are masked as not found; malformed or\nwrong-kind identities are invalid requests.\n",
        "tags": [
          "Product"
        ],
        "security": [
          {
            "BearerAuth": [
              "covers:read"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          }
        ],
        "responses": {
          "200": {
            "description": "Product retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                },
                "examples": {
                  "full_product": {
                    "summary": "Fully configured liability product",
                    "value": {
                      "data": {
                        "id": "prd_3f8a9c1e2b7d4f60",
                        "product_code": "LIAB-PROF-2026",
                        "name": "Professional Indemnity Insurance",
                        "type": "liability",
                        "status": "active",
                        "description": "Professional indemnity cover for regulated professionals including legal, accounting, and consulting firms",
                        "currency": "eur",
                        "attributes": {
                          "market": "EMEA",
                          "eligible_professions": [
                            "legal",
                            "accounting",
                            "consulting",
                            "engineering"
                          ]
                        },
                        "covers": [
                          {
                            "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                            "code": "PI-CLAIMS",
                            "name": "Professional Negligence Claims",
                            "type": "basic",
                            "sum_insured": 2000000,
                            "deductible": 5000,
                            "status": "active"
                          },
                          {
                            "id": "cov_01abcdefghjkmnpqrstvwxyz02",
                            "code": "PI-DEFENCE",
                            "name": "Legal Defence Costs",
                            "type": "basic",
                            "sum_insured": 500000,
                            "deductible": 0,
                            "status": "active"
                          }
                        ],
                        "terms": [
                          {
                            "code": "RETRO-DATE",
                            "name": "Retroactive Date",
                            "data_type": "date",
                            "required": true
                          },
                          {
                            "code": "RUN-OFF-YEARS",
                            "name": "Run-Off Period",
                            "data_type": "integer",
                            "required": false,
                            "default_value": "6"
                          }
                        ],
                        "pricing_rules": [
                          {
                            "name": "Revenue Band Rating",
                            "rule_type": "risk_factor",
                            "base_rate": 0.005,
                            "expression": "revenue_band == 'high' ? 0.008 : 0.005",
                            "status": "active"
                          }
                        ],
                        "commissions": [
                          {
                            "role_type": "broker",
                            "commission_type": "initial",
                            "rate": 0.15,
                            "calculation_basis": "gross_premium",
                            "status": "active"
                          }
                        ],
                        "created_at": "2026-02-01T10:00:00Z",
                        "updated_at": "2026-03-01T16:00:00Z"
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:read"
          ],
          "required_permissions": [
            "covers:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/{id}/sections": {
      "get": {
        "operationId": "listProductCovers",
        "security": [
          {
            "BearerAuth": [
              "covers:read"
            ]
          }
        ],
        "summary": "Get coverage sections for a product",
        "description": "Retrieve all coverage sections (covers) defined for a product. Each cover\nincludes its sum insured, deductible, type (basic/optional/rider), and any\nassociated cover provision definitions and terms.\n",
        "tags": [
          "Product"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          }
        ],
        "responses": {
          "200": {
            "description": "Covers retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CoverListResponse"
                },
                "examples": {
                  "motor_covers": {
                    "summary": "Motor product coverage sections",
                    "value": {
                      "data": [
                        {
                          "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                          "code": "TPL-BODILY",
                          "name": "Third-Party Bodily Injury",
                          "description": "Covers liability for bodily injury to third parties",
                          "type": "basic",
                          "sum_insured": 1000000,
                          "deductible": 0,
                          "status": "active"
                        },
                        {
                          "id": "cov_01abcdefghjkmnpqrstvwxyz02",
                          "code": "TPL-PROPERTY",
                          "name": "Third-Party Property Damage",
                          "description": "Covers liability for damage to third-party property",
                          "type": "basic",
                          "sum_insured": 25000000,
                          "deductible": 50000,
                          "status": "active"
                        },
                        {
                          "id": "cov_01abcdefghjkmnpqrstvwxyz03",
                          "code": "WINDSCREEN",
                          "name": "Windscreen Cover",
                          "description": "Covers repair or replacement of windscreens and vehicle glass",
                          "type": "optional",
                          "sum_insured": 500000,
                          "deductible": 0,
                          "status": "active"
                        }
                      ],
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:read"
          ],
          "required_permissions": [
            "covers:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "addProductCoverSection",
        "summary": "Add a coverage section (cover) to a product",
        "description": "CRS-3: add a cover to a draft product. The cover may carry nested\n`cover_items` (each with `terms`) and cover-level `cover_terms`, persisted\nas the full canonical cover.* row graph in one atomic transaction. Money\nboundaries are exact integer minor units with a lowercase ISO-4217 currency;\na monetary boundary missing its currency is rejected (422). Co-insurance\npanel splits (basis points) must sum to 10000bp (100%) or the request is\nrejected (422).\n",
        "tags": [
          "Product"
        ],
        "security": [
          {
            "BearerAuth": [
              "covers:write"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddCoverRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Cover added successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CoverResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "**422 Unprocessable Entity** \u2014 the cover failed a business-rule\nvalidation (unknown cover-item kind, a money boundary missing its\ncurrency, or a co-insurance panel not summing to 10000bp).\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:write"
          ],
          "required_permissions": [
            "covers:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/{id}/pricing-rules": {
      "post": {
        "operationId": "assignProductPricingRules",
        "x-axiom-substrate-kind": "binding",
        "x-axiom-substrate-id": "product-ruleset-bindings",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Bind a product to a ruleset version for a pipeline stage",
        "description": "Creates or supersedes the active product\u2194ruleset binding for the given\n`ruleset_type` (pipeline stage). under the governed contract a single product\ncarries one binding per `(tenant context, product_id, ruleset_type,\neffective_from)`; binding a different `ruleset_type` does NOT close the\nprior stage's active row \u2014 supersession is per-stage.\n\n`ruleset_type` is REQUIRED and must be in the canonical allowlist\n(see `400 INVALID_RULESET_TYPE` body for the accepted set). Earlier\nruntime behaviour silently defaulted the field to `claims_assessment`\nat the persistence boundary. The current contract rejects missing or\nunknown values at the HTTP boundary with the accepted set listed in the\nerror body.\n",
        "tags": [
          "Product"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 255
            },
            "description": "Stable caller-supplied key used to replay an identical mutation response and reject key reuse with a different request."
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ruleset_id",
                  "ruleset_type",
                  "ruleset_version",
                  "effective_from"
                ],
                "properties": {
                  "ruleset_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
                    "description": "Typed-prefix identifier of the ruleset to bind to the product.",
                    "example": "rst_01arz3ndektsv4rrffq69g5fav",
                    "x-axiom-identifier-classification": "ruleset-id",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "ruleset_type": {
                    "type": "string",
                    "description": "Pipeline stage the binding satisfies. Must be in the canonical\nallowlist; see 400 INVALID_RULESET_TYPE response for the full set.\n",
                    "example": "premium_rating"
                  },
                  "ruleset_version": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Version number of the bound ruleset",
                    "example": 1
                  },
                  "effective_from": {
                    "type": "string",
                    "format": "date",
                    "description": "Date this binding becomes active (YYYY-MM-DD)",
                    "example": "2026-01-01"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Binding created or superseded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductRulesetBindingResponse"
                },
                "examples": {
                  "binding_created": {
                    "summary": "Ruleset binding created",
                    "value": {
                      "data": {
                        "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                        "product_id": "prd_d4e5f6a7b8c90123def0123456789abc",
                        "ruleset_id": "rst_01abcdefghjkmnpqrstvwxyz01",
                        "ruleset_type": "premium_rating",
                        "ruleset_version": 1,
                        "effective_from": "2026-01-01T00:00:00Z",
                        "created_by": "usr_abc123"
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listProductPricingRules",
        "x-axiom-substrate-kind": "binding",
        "x-axiom-substrate-id": "product-ruleset-bindings",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "List product\u2194ruleset bindings (active and historical)",
        "description": "Returns the binding history for a product in deterministic order\n(effective_from DESC, created_at DESC, id DESC). Each item includes\n`ruleset_type` so callers can distinguish stages without re-querying.\n\nOptional `?ruleset_type=` filter narrows the response to a single\nstage. Unknown values are rejected with 400 INVALID_RULESET_TYPE\n(no silent empty-list).\n",
        "tags": [
          "Product"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          },
          {
            "name": "ruleset_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Filter by pipeline stage; must be in the canonical allowlist"
          }
        ],
        "responses": {
          "200": {
            "description": "Bindings retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductRulesetBindingListResponse"
                },
                "examples": {
                  "bindings_list": {
                    "summary": "Active and historical bindings",
                    "value": {
                      "data": [
                        {
                          "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                          "product_id": "prd_d4e5f6a7b8c90123def0123456789abc",
                          "ruleset_id": "rst_01abcdefghjkmnpqrstvwxyz01",
                          "ruleset_type": "premium_rating",
                          "ruleset_version": 2,
                          "effective_from": "2026-03-01T00:00:00Z",
                          "created_by": "usr_abc123"
                        },
                        {
                          "id": "cov_01abcdefghjkmnpqrstvwxyz01",
                          "product_id": "prd_d4e5f6a7b8c90123def0123456789abc",
                          "ruleset_id": "rst_01abcdefghjkmnpqrstvwxyz01",
                          "ruleset_type": "premium_rating",
                          "ruleset_version": 1,
                          "effective_from": "2026-01-01T00:00:00Z",
                          "effective_to": "2026-03-01T00:00:00Z",
                          "created_by": "usr_abc123"
                        }
                      ],
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "ruleset_type"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/{id}/activate": {
      "post": {
        "operationId": "activateProduct",
        "summary": "Activate a draft product",
        "description": "Transition a product from draft to active status. The product must have at\nleast one cover and defined terms (with explicit validation bounds) before\nactivation.\n\nThis is a status-only transition: it does NOT re-persist the product's\ncover graph, so it never collides on existing covers (unlike a full\nPUT update). Side effects: persists the status change and emits a formal\nactivation explanation tree (governed contract).\n",
        "tags": [
          "Product"
        ],
        "security": [
          {
            "BearerAuth": [
              "covers:write"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ActivateProductRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Product activated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:write"
          ],
          "required_permissions": [
            "covers:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/{id}/decision-evaluations": {
      "post": {
        "operationId": "createProductDecisionEvaluation",
        "x-axiom-substrate-kind": "decision-evaluation-contract",
        "x-axiom-substrate-id": "product-decision-evaluation-runtime-binding",
        "x-axiom-configurability": "tenant-product-decision",
        "summary": "Evaluate a governed product decision intent",
        "description": "Contract-admitted operation for external process tooling to ask Axiom a\nnamed governed product decision question at a process decision point.\nAxiom owns tenant context, product binding resolution, ruleset/pipeline\nselection, audit evidence, and explanation evidence.\n\nSlice 3 wires the operation to the governed ruleset/pipeline execution\nsubstrate. A runtime call is parsed, tenant-bound, actor-bound, checked\nagainst the contract-owned allowlists, resolved through Axiom-owned\nbinding and pipeline authority, and returns a business outcome only after\naudit and explanation evidence are persisted.\n\nMissing binding, missing active pipeline template, failed execution,\nfailed audit persistence, or failed explanation persistence remains a\ntyped technical error. These failures must never be converted into a\nrouteable business decision.\n\nCallers must not supply raw `ruleset_id`, raw pipeline template\nidentifiers, tenant authority fields, retention policy, explanation\naudience overrides, or transport-failure-to-business-outcome mappings.\nBPMN and workflow engines route only on the stable `decision_code`\nreturned by Axiom after a successful evaluation.\n",
        "tags": [
          "Product"
        ],
        "security": [
          {
            "BearerAuth": [
              "covers:evaluate"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^prd_[A-Za-z0-9]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 128,
              "pattern": "^[A-Za-z0-9._:-]+$"
            },
            "description": "Idempotency key scoped by operating tenant."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductDecisionEvaluationRequest"
              },
              "examples": {
                "premium_rating": {
                  "summary": "Premium-rating route decision",
                  "value": {
                    "decision_intent": "quote.premium_rating",
                    "product_stage": "quotation",
                    "effective_at": "2026-09-06T10:00:00Z",
                    "requested_outputs": [
                      "decision_code",
                      "reason_codes",
                      "routeable_outputs",
                      "premium_amount"
                    ],
                    "facts": {
                      "party_ref": "par_01example000000000000000001",
                      "quote_ref": "quo_01example000000000000000001",
                      "declared_income_band": "middle",
                      "smoker_status": false,
                      "requested_cover_amount_minor": 50000000,
                      "currency": "zar"
                    },
                    "canonical_request_hash": "sha256:0c4f36305a512094cb6ec2e150823254a2db606243293c210a8def41ed0be464"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Product decision evaluated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDecisionEvaluationResponse"
                },
                "examples": {
                  "premium_rated": {
                    "summary": "Deterministic routeable decision result",
                    "value": {
                      "data": {
                        "decision_evaluation_id": "pde_01example000000000000000001",
                        "decision_intent": "quote.premium_rating",
                        "product_stage": "quotation",
                        "decision_code": "accept",
                        "reason_codes": [
                          "premium_rated"
                        ],
                        "routeable_outputs": {
                          "next_route": "continue_to_underwriting",
                          "premium_amount": {
                            "amount_minor": 125000,
                            "currency": "zar"
                          }
                        },
                        "binding": {
                          "ruleset_type": "premium_rating",
                          "ruleset_id": "rst_01abcdefghjkmnpqrstvwxyz01",
                          "ruleset_version": 3,
                          "pipeline_version": "pipe_2026_09_06",
                          "effective_at": "2026-09-06T10:00:00Z"
                        },
                        "audit_ref": "aud_01example000000000000000001",
                        "explanation_ref": "exp_01example000000000000000001",
                        "evaluation_at": "2026-09-06T10:00:01Z",
                        "canonical_request_hash": "sha256:0c4f36305a512094cb6ec2e150823254a2db606243293c210a8def41ed0be464"
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "501": {
            "description": "Runtime evaluation is not implemented for this contract-admitted operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "runtime_unimplemented": {
                    "summary": "Runtime service unavailable in deployment",
                    "value": {
                      "errors": [
                        {
                          "status": "501",
                          "code": "RUNTIME_UNIMPLEMENTED",
                          "title": "Evaluation Runtime Not Implemented",
                          "detail": "The product decision evaluation contract is admitted, but runtime evaluation is not available on this deployment."
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "covers:evaluate"
          ],
          "required_permissions": [
            "covers:evaluate"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/covers/{id}/audit": {
      "parameters": [
        {
          "name": "X-Tenant-Context",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
        },
        {
          "name": "X-Correlation-ID",
          "in": "header",
          "required": false,
          "schema": {
            "type": "string",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "description": "Request correlation ID for tracing"
        },
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^prd_[A-Za-z0-9]+$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "description": "Typed product identifier rendered by the API. The storage UUID remains internal."
        }
      ],
      "get": {
        "operationId": "getCoversIdAudit",
        "summary": "Chronological audit feed for a product",
        "description": "Returns the per-product audit feed in descending performed-at order.\nThe feed is scoped to the admitted tenant context, verifies that the\nproduct exists before reading audit rows, and never returns a silent empty\nfeed for an unknown product identifier.\n\nUse `page[size]` and `page[after]` for cursor pagination. Legacy\n`limit` and `offset` query parameters are rejected by the runtime.\n",
        "tags": [
          "Product"
        ],
        "parameters": [
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 25,
              "minimum": 1,
              "maximum": 100
            },
            "description": "Maximum number of audit entries to return."
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Resource-bound keyset cursor from meta.next_cursor; old offset cursors return 400 and require traversal restart."
          }
        ],
        "responses": {
          "200": {
            "description": "Audit feed for this product",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntityAuditListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies": {
      "post": {
        "operationId": "createPolicy",
        "summary": "Create a new policy",
        "description": "Issue a new insurance policy under an active product. The policy is created in\n\"draft\" status by default. At least one party must be assigned (typically the\npolicyholder). Draft policies are not endorsement-eligible; use\n`POST /v1/policies/bind` to create an active, endorsement-eligible policy.\n\nThe product must be in \"active\" status before policies can be issued against it.\nThe effective date must not be in the past (backdating requires special permissions).\n\nSide effects: persists the policy in draft status with assigned parties; emits an audit entry recording the creation.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePolicyRequest"
              },
              "examples": {
                "motor_policy": {
                  "summary": "Motor third-party liability policy (UK)",
                  "value": {
                    "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                    "effective_date": "2026-04-01",
                    "expiry_date": "2027-03-31",
                    "attributes": {
                      "vehicle_registration": "AB12 CDE",
                      "vehicle_make": "Volkswagen",
                      "vehicle_model": "Golf",
                      "vehicle_year": 2023,
                      "sum_insured": 1000000,
                      "territory": "UK"
                    },
                    "parties": [
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "policyholder"
                      },
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "insured"
                      }
                    ],
                    "created_by": "agent-user-012"
                  }
                },
                "health_policy": {
                  "summary": "Health cover policy",
                  "value": {
                    "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                    "effective_date": "2026-05-01",
                    "expiry_date": "2027-04-30",
                    "attributes": {
                      "plan_level": "comprehensive",
                      "dependents": 3,
                      "chronic_conditions": [
                        "diabetes_type_2"
                      ]
                    },
                    "parties": [
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "policyholder"
                      },
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "dependent"
                      },
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "beneficiary"
                      }
                    ],
                    "created_by": "broker-portal"
                  }
                },
                "life_policy": {
                  "summary": "Term life assurance (Nigeria)",
                  "value": {
                    "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                    "effective_date": "2026-06-01",
                    "expiry_date": "2046-05-31",
                    "attributes": {
                      "sum_assured": 50000000,
                      "currency": "NGN",
                      "smoker_status": "non_smoker"
                    },
                    "parties": [
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "policyholder"
                      },
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "insured"
                      },
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "role": "beneficiary"
                      }
                    ],
                    "created_by": "agent-user-042"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Policy created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyResponse"
                },
                "examples": {
                  "motor_created": {
                    "summary": "Motor policy created",
                    "value": {
                      "data": {
                        "id": "pol_01abcdefghjkmnpqrstvwxyz01",
                        "policy_number": "POL-2026-000142",
                        "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                        "status": "draft",
                        "effective_date": "2026-04-01",
                        "expiry_date": "2027-03-31",
                        "attributes": {
                          "vehicle_registration": "AB12 CDE",
                          "vehicle_make": "Volkswagen",
                          "vehicle_model": "Golf",
                          "vehicle_year": 2023,
                          "sum_insured": 1000000,
                          "territory": "UK"
                        },
                        "parties": [
                          {
                            "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                            "party_type": "individual",
                            "role": "policyholder",
                            "status": "active",
                            "assigned_at": "2026-03-12T08:00:00Z"
                          },
                          {
                            "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                            "party_type": "individual",
                            "role": "insured",
                            "status": "active",
                            "assigned_at": "2026-03-12T08:00:00Z"
                          }
                        ],
                        "created_at": "2026-03-12T08:00:00Z",
                        "updated_at": "2026-03-12T08:00:00Z"
                      },
                      "status": "success",
                      "message": "Policy created successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listPolicies",
        "summary": "List policies",
        "description": "Retrieve a cursor-paginated list of policies for the tenant.\nResults are sorted by most-recently-recorded first. Sort order is not configurable.\nLegacy `limit` and `offset` query parameters are rejected.\n\nReturns policies across all statuses (draft, quoted, bound, active, lapsed, cancelled, expired).\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of policies to return in this cursor page"
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor returned as meta.next_cursor by the previous page"
          },
          {
            "name": "party_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pty_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "party-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Optional filter \u2014 return only policies the party is bound to in any role\n(the party appears in `policy.parties`). Accepts the canonical typed-prefix\nparty id (`pty_\u2026`, governed contract). A malformed value returns 400. Absent =\nall policies for the tenant (current behaviour). Composes with the\nexisting operating-tenant tenant-isolated scope; never widens it.\n"
          }
        ],
        "responses": {
          "200": {
            "description": "Policies retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyListResponse"
                },
                "examples": {
                  "policy_list": {
                    "summary": "Policies across statuses and verticals",
                    "value": {
                      "data": [
                        {
                          "id": "pol_01abcdefghjkmnpqrstvwxyz01",
                          "policy_number": "POL-2026-000142",
                          "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                          "status": "active",
                          "effective_date": "2026-04-01",
                          "expiry_date": "2027-03-31",
                          "created_at": "2026-03-12T08:00:00Z",
                          "updated_at": "2026-04-01T00:00:00Z"
                        },
                        {
                          "id": "pol_01abcdefghjkmnpqrstvwxyz02",
                          "policy_number": "POL-2026-000143",
                          "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                          "status": "cancelled",
                          "effective_date": "2026-03-01",
                          "expiry_date": "2027-02-28",
                          "created_at": "2026-02-28T11:00:00Z",
                          "updated_at": "2026-03-10T09:00:00Z"
                        }
                      ],
                      "meta": {
                        "page_size": 20,
                        "has_more": false
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "party_id"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/bind": {
      "post": {
        "description": "Bind parties to covers through an active policy version. This contract is the primary policy-creation operation \u2014 it reads party and covers/products context, creates an immutable policy version, and conditionally triggers premium effects. Requires idempotency: callers must supply an idempotency key to prevent duplicate policy creation on retry.",
        "operationId": "bindPolicy",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PolicyBindRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyBindResponse"
                }
              }
            },
            "description": "Policy bound successfully"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Invalid request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Authentication required"
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Insufficient permissions"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Quote not found (QUOTE_NOT_FOUND)"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Idempotency key reused (IDEMPOTENCY_KEY_REUSED)"
          },
          "410": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Quote expired (QUOTE_EXPIRED)"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Validation error (PREMIUM_DRIFT_EXCEEDED or POLICY_NOT_YET_EFFECTIVE_FOR_BIND)"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Server Error"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "policies:bind"
            ]
          }
        ],
        "summary": "Bind Policy",
        "tags": [
          "Policy"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "policies:bind"
          ],
          "required_permissions": [
            "policies:bind"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}": {
      "get": {
        "operationId": "getPolicy",
        "summary": "Get a policy by ID",
        "description": "Retrieve a single policy with its full details including assigned parties\nand premium schedule.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Policy retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyResponse"
                },
                "examples": {
                  "active_policy": {
                    "summary": "Active motor policy with parties and premiums",
                    "value": {
                      "data": {
                        "id": "pol_01abcdefghjkmnpqrstvwxyz01",
                        "policy_number": "POL-2026-000142",
                        "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                        "status": "active",
                        "effective_date": "2026-04-01",
                        "expiry_date": "2027-03-31",
                        "attributes": {
                          "vehicle_registration": "AB12 CDE",
                          "vehicle_make": "Volkswagen",
                          "vehicle_model": "Golf",
                          "sum_insured": 1000000
                        },
                        "parties": [
                          {
                            "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                            "party_type": "individual",
                            "role": "policyholder",
                            "status": "active",
                            "assigned_at": "2026-03-12T08:00:00Z"
                          }
                        ],
                        "premiums": [
                          {
                            "id": "pms_01abcdefghjkmnpqrstvwxyz01",
                            "amount": 11500,
                            "due_date": "2026-04-01",
                            "status": "paid",
                            "payment_method": "debit_order"
                          },
                          {
                            "id": "pms_01abcdefghjkmnpqrstvwxyz02",
                            "amount": 11500,
                            "due_date": "2026-05-01",
                            "status": "pending",
                            "payment_method": "debit_order"
                          }
                        ],
                        "created_at": "2026-03-12T08:00:00Z",
                        "updated_at": "2026-04-01T00:00:00Z"
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/versions": {
      "post": {
        "operationId": "createPolicyVersion",
        "summary": "Create a new policy version",
        "description": "Create a new version snapshot of the policy. Policy versions provide an immutable\nrecord of the policy state at each point in time, supporting \"as-was\" semantics\nrequired for claims adjudication and regulatory reporting.\n\nEach version captures the complete policy state including attributes, parties,\nand coverage details at the time of creation.\n\nSide effects: creates a new immutable policy version through the VersionService,\nincluding retroactive guard enforcement, rule snapshot capture, atomic close/open\nvalidity transition, explanation provenance, outbox emission, and post-mutation\naudit.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "effective_date"
                ],
                "properties": {
                  "effective_date": {
                    "type": "string",
                    "format": "date",
                    "description": "Date from which this version takes effect",
                    "example": "2026-06-01"
                  },
                  "reason": {
                    "type": "string",
                    "description": "Reason for creating a new version",
                    "example": "Mid-term adjustment following endorsement END-001"
                  },
                  "created_by": {
                    "type": "string",
                    "description": "Identifier of the user or service creating this version",
                    "example": "underwriter-user-003"
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "endorsement_version": {
                  "summary": "Version created after endorsement",
                  "value": {
                    "effective_date": "2026-06-01",
                    "reason": "Mid-term adjustment \u2014 sum insured increase from 250,000 to 300,000",
                    "created_by": "underwriter-user-003"
                  }
                },
                "renewal_version": {
                  "summary": "Version created at renewal",
                  "value": {
                    "effective_date": "2027-04-01",
                    "reason": "Annual renewal \u2014 updated premium and vehicle value",
                    "created_by": "renewal-system"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Policy version created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyVersionResponse"
                },
                "examples": {
                  "version_created": {
                    "summary": "New policy version",
                    "value": {
                      "data": {
                        "id": "pov_01abcdefghjkmnpqrstvwxyz02",
                        "policy_id": "pol_01abcdefghjkmnpqrstvwxyz01",
                        "version_number": 2,
                        "version_type": "endorsement",
                        "effective_from": "2026-06-01T00:00:00Z",
                        "effective_to": null,
                        "change_reason": "Mid-term adjustment \u2014 sum insured increase from 250,000 to 300,000",
                        "created_by": "underwriter-user-003",
                        "previous_version": "pov_01abcdefghjkmnpqrstvwxyz01",
                        "created_at": "2026-05-28T14:00:00Z"
                      },
                      "status": "success",
                      "message": "Policy version created successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listPolicyVersions",
        "summary": "List policy version snapshots",
        "description": "Return every immutable version snapshot for the policy, ordered by\nversion_number ascending. Backs the application Policies \u2192 Versions tab.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Policy versions retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyVersionListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/issue": {
      "post": {
        "operationId": "issuePolicy",
        "summary": "Issue a draft policy",
        "description": "Transition a policy from draft to bound status. The policy must have at\nleast one party with the policyholder role assigned.\n\nSide effects: persists the status change and emits an audit entry with\noperation code policy.issue in a single transaction.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "issued_by"
                ],
                "properties": {
                  "issued_by": {
                    "type": "string",
                    "description": "Identifier of the user or service issuing the policy"
                  },
                  "notes": {
                    "type": "string",
                    "description": "Optional notes for the issue action"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Policy issued successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyResponse"
                },
                "examples": {
                  "issued": {
                    "summary": "Draft policy bound",
                    "value": {
                      "data": {
                        "id": "pol_01abcdefghjkmnpqrstvwxyz01",
                        "policy_number": "POL-2026-000142",
                        "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                        "status": "bound",
                        "effective_date": "2026-04-01",
                        "expiry_date": "2027-03-31",
                        "created_at": "2026-03-12T08:00:00Z",
                        "updated_at": "2026-03-20T10:00:00Z"
                      },
                      "status": "success",
                      "message": "Policy issued successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/activate": {
      "post": {
        "operationId": "activatePolicy",
        "summary": "Activate a bound policy",
        "description": "Transition a policy from bound to active status. The policy's effective\ndate must be in the past or present (effective_date <= now).\n\nSide effects: persists the status change and emits an audit entry with\noperation code policy.activate in a single transaction.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "activated_by"
                ],
                "properties": {
                  "activated_by": {
                    "type": "string",
                    "description": "Identifier of the user or service activating the policy"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Policy activated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyResponse"
                },
                "examples": {
                  "activated": {
                    "summary": "Issued policy activated",
                    "value": {
                      "data": {
                        "id": "pol_01abcdefghjkmnpqrstvwxyz01",
                        "policy_number": "POL-2026-000142",
                        "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                        "status": "active",
                        "effective_date": "2026-04-01",
                        "expiry_date": "2027-03-31",
                        "created_at": "2026-03-12T08:00:00Z",
                        "updated_at": "2026-03-20T10:30:00Z"
                      },
                      "status": "success",
                      "message": "Policy activated successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/allocation-simulations": {
      "post": {
        "operationId": "createAllocationSimulation",
        "summary": "Simulate an allocation breakdown",
        "description": "Validates a proposed allocation breakdown without persisting it.\nAccepts only simulation_preview as trigger. Returns 422 for semantic\nvalidation failures (sum mismatch, missing rule_id, invalid inputs).\n\nEach operation in the request specifies a benefit change (add, remove,\nchange) with proposed allocation values in allocation_inputs.\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Policy identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/vnd.api+json": {
              "schema": {
                "type": "object",
                "required": [
                  "data"
                ],
                "properties": {
                  "data": {
                    "type": "object",
                    "required": [
                      "type",
                      "attributes"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "allocation-simulations"
                        ]
                      },
                      "attributes": {
                        "type": "object",
                        "required": [
                          "trigger",
                          "operations"
                        ],
                        "properties": {
                          "as_of": {
                            "type": "string",
                            "format": "date-time",
                            "description": "Optional point-in-time for simulation context"
                          },
                          "base_policy_version_id": {
                            "type": "string",
                            "description": "Optional base policy version override",
                            "x-axiom-identifier-classification": "policy-version-id",
                            "x-axiom-identifier-shape": "opaque-string"
                          },
                          "trigger": {
                            "type": "string",
                            "enum": [
                              "simulation_preview"
                            ]
                          },
                          "operations": {
                            "type": "array",
                            "minItems": 1,
                            "items": {
                              "type": "object",
                              "required": [
                                "op",
                                "benefit_id"
                              ],
                              "properties": {
                                "op": {
                                  "type": "string",
                                  "enum": [
                                    "add_benefit",
                                    "remove_benefit",
                                    "change_benefit"
                                  ]
                                },
                                "benefit_id": {
                                  "type": "string",
                                  "x-axiom-identifier-classification": "cover-id",
                                  "x-axiom-identifier-shape": "opaque-string"
                                },
                                "allocation_inputs": {
                                  "type": "object",
                                  "description": "Proposed allocation values for validation",
                                  "properties": {
                                    "amount": {
                                      "allOf": [
                                        {
                                          "$ref": "#/components/schemas/Money"
                                        }
                                      ],
                                      "description": "Proposed allocated amount (exact integer minor units + lowercase ISO-4217 currency code)."
                                    },
                                    "allocation_percentage_bps": {
                                      "type": "integer",
                                      "format": "int32"
                                    },
                                    "allocation_basis": {
                                      "type": "string",
                                      "enum": [
                                        "bottom_up",
                                        "fixed",
                                        "rule_based"
                                      ]
                                    },
                                    "calculation_version": {
                                      "type": "string"
                                    },
                                    "allocation_rule_id": {
                                      "type": "string",
                                      "format": "typed-prefix-id",
                                      "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
                                      "description": "Typed-prefix identifier for the allocation rule when allocation_basis is rule_based.",
                                      "x-axiom-identifier-shape": "typed-prefix"
                                    }
                                  },
                                  "additionalProperties": false
                                }
                              },
                              "additionalProperties": false
                            }
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Simulation completed successfully",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "type",
                          "id",
                          "attributes"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "allocation-simulations"
                            ]
                          },
                          "id": {
                            "type": "string",
                            "format": "typed-prefix-id",
                            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
                            "example": "pol_01arz3ndektsv4rrffq69g5fav",
                            "x-axiom-identifier-classification": "policy-id",
                            "x-axiom-identifier-shape": "typed-prefix"
                          },
                          "attributes": {
                            "type": "object",
                            "properties": {
                              "benefit_id": {
                                "type": "string",
                                "x-axiom-identifier-classification": "cover-id",
                                "x-axiom-identifier-shape": "opaque-string"
                              },
                              "amount": {
                                "allOf": [
                                  {
                                    "$ref": "#/components/schemas/Money"
                                  }
                                ],
                                "description": "Allocated amount (exact integer minor units + lowercase ISO-4217 currency code)."
                              },
                              "allocation_percentage_bps": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "allocation_basis": {
                                "type": "string"
                              },
                              "calculation_version": {
                                "type": "string"
                              },
                              "allocation_rule_id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "typed-prefix-id",
                                "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
                                "description": "Typed-prefix identifier for the allocation rule when allocation_basis is rule_based."
                              },
                              "trigger": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "simulated": {
                          "type": "boolean"
                        },
                        "calculation_version": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (wrong content type, missing fields)",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Policy not found (POLICY_NOT_FOUND)",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "409": {
            "description": "Version conflict \u2014 no resolvable base policy version (VERSION_CONFLICT)",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "422": {
            "description": "Semantic validation failure (sum mismatch, missing rule_id, invalid trigger)",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/allocation-history": {
      "get": {
        "operationId": "listPolicyAllocationHistory",
        "summary": "List temporal allocation history for a policy",
        "description": "Returns cursor-paginated temporal allocation snapshots for all premiums\nin a policy. Ordered by effective_from DESC, created_at DESC, premium_id ASC.\nUses half-open [effective_from, effective_to) temporal semantics under the governed contract.\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Policy identifier"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Number of resources per page"
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Cursor for forward pagination (allocation ID)"
          },
          {
            "name": "page[before]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Cursor for backward pagination (allocation ID)"
          }
        ],
        "responses": {
          "200": {
            "description": "Allocation history retrieved successfully",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "type",
                          "id",
                          "attributes"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "policy-allocation-history-entries"
                            ]
                          },
                          "id": {
                            "type": "string",
                            "format": "typed-prefix-id",
                            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
                            "example": "pol_01arz3ndektsv4rrffq69g5fav",
                            "x-axiom-identifier-classification": "policy-id",
                            "x-axiom-identifier-shape": "typed-prefix"
                          },
                          "attributes": {
                            "type": "object",
                            "required": [
                              "premium_id",
                              "benefit_id",
                              "amount",
                              "allocation_percentage_bps",
                              "allocation_basis",
                              "calculation_version",
                              "effective_from",
                              "trigger"
                            ],
                            "properties": {
                              "premium_id": {
                                "type": "string",
                                "format": "typed-prefix-id",
                                "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
                                "example": "prm_01arz3ndektsv4rrffq69g5fav",
                                "x-axiom-identifier-classification": "premium-id",
                                "x-axiom-identifier-shape": "typed-prefix"
                              },
                              "benefit_id": {
                                "type": "string",
                                "x-axiom-identifier-classification": "cover-id",
                                "x-axiom-identifier-shape": "opaque-string"
                              },
                              "amount": {
                                "allOf": [
                                  {
                                    "$ref": "#/components/schemas/Money"
                                  }
                                ],
                                "description": "Allocated amount (exact integer minor units + lowercase ISO-4217 currency code)."
                              },
                              "allocation_percentage_bps": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "allocation_basis": {
                                "type": "string",
                                "enum": [
                                  "bottom_up",
                                  "fixed",
                                  "rule_based"
                                ]
                              },
                              "calculation_version": {
                                "type": "string"
                              },
                              "allocation_rule_id": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "effective_from": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "effective_to": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "date-time"
                              },
                              "trigger": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page_size": {
                          "type": "integer"
                        },
                        "has_more": {
                          "type": "boolean"
                        },
                        "next_cursor": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (missing policy id)",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]",
            "page[before]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/endorsements": {
      "post": {
        "operationId": "createEndorsement",
        "x-axiom-substrate-kind": "lifecycle",
        "x-axiom-substrate-id": "policy-endorsement-lifecycle",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Create a policy endorsement",
        "description": "Submit an endorsement (mid-term adjustment) to an **active** policy. Endorsements\nrecord structured changes to the policy terms, coverage, or parties.\nThe policy must be in `active` status; endorsing a `draft` or other non-active\npolicy returns HTTP 422 with code `INVALID_STATE_TRANSITION`.\n\nEach endorsement receives a sequential number within the policy (END-001, END-002, etc.)\nand triggers the creation of a new policy version when applied.\n\nSide effects: creates a new immutable policy version and persists party-role\nchanges when `change_type=parties`. Emits an audit entry when audit is configured.\n\nCommon endorsement types:\n- amendment: Modify existing terms (e.g. change address, increase sum insured)\n- addition: Add new coverage or parties\n- deletion: Remove coverage or parties\n- correction: Fix data entry errors\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "change_type",
                  "description",
                  "endorsed_by"
                ],
                "properties": {
                  "change_type": {
                    "type": "string",
                    "description": "Classification of the endorsement change",
                    "enum": [
                      "parties",
                      "coverages",
                      "terms",
                      "premium"
                    ],
                    "example": "coverages"
                  },
                  "description": {
                    "type": "string",
                    "description": "Human-readable description of the changes",
                    "example": "Increase sum insured from R250,000 to R300,000 and update insured address"
                  },
                  "new_parties": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "party_id",
                        "role"
                      ],
                      "properties": {
                        "party_id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "pty_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "party-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "role": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    },
                    "description": "New parties to add (for change_type 'parties')"
                  },
                  "updated_attributes": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": true,
                    "description": "Structured representation of attribute changes",
                    "example": {
                      "sum_insured": {
                        "from": 250000,
                        "to": 300000
                      },
                      "address": {
                        "from": "42 Baker Street, London",
                        "to": "18 Regent Street, London"
                      }
                    }
                  },
                  "endorsed_by": {
                    "type": "string",
                    "description": "Identifier of the user or process creating the endorsement",
                    "example": "underwriter-user-003"
                  },
                  "effective_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Effective timestamp for party endorsements (change_type=parties).\nMust not be retroactive. Required when change_type=parties.\n"
                  },
                  "party_changes": {
                    "type": "array",
                    "description": "Party mutations for change_type=parties endorsements. Each entry\nspecifies an operation (add/revoke/replace), party_id, and role.\n",
                    "items": {
                      "type": "object",
                      "required": [
                        "op",
                        "party_id",
                        "role"
                      ],
                      "properties": {
                        "op": {
                          "type": "string",
                          "enum": [
                            "add",
                            "revoke",
                            "replace"
                          ]
                        },
                        "party_id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "pty_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "party-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "role": {
                          "type": "string",
                          "enum": [
                            "policyholder",
                            "dependent",
                            "insured",
                            "beneficiary",
                            "agent",
                            "broker"
                          ]
                        }
                      },
                      "additionalProperties": false
                    }
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "increase_sum_insured": {
                  "summary": "Increase motor policy sum insured",
                  "value": {
                    "change_type": "coverages",
                    "description": "Increase vehicle insured value following market revaluation",
                    "updated_attributes": {
                      "sum_insured": {
                        "from": 350000,
                        "to": 420000
                      },
                      "monthly_premium": {
                        "from": 1850,
                        "to": 2150
                      }
                    },
                    "endorsed_by": "underwriter-user-003"
                  }
                },
                "add_driver": {
                  "summary": "Add named driver to motor policy",
                  "value": {
                    "change_type": "parties",
                    "description": "Add spouse as named driver with full driving history",
                    "new_parties": [
                      {
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz02",
                        "role": "insured"
                      }
                    ],
                    "updated_attributes": {
                      "named_drivers": {
                        "added": [
                          {
                            "name": "Jane Smith",
                            "licence_number": "SMITH801010JA9AB",
                            "years_driving": 12
                          }
                        ]
                      }
                    },
                    "endorsed_by": "agent-user-012"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Endorsement created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndorsementResponse"
                },
                "examples": {
                  "endorsement_created": {
                    "summary": "Endorsement pending application",
                    "value": {
                      "data": {
                        "id": "pov_01abcdefghjkmnpqrstvwxyz03",
                        "policy_id": "pol_01abcdefghjkmnpqrstvwxyz01",
                        "endorsement_number": "END-001",
                        "type": "amendment",
                        "description": "Increase vehicle insured value following market revaluation",
                        "effective_date": "2026-07-01",
                        "status": "pending",
                        "changes": {
                          "sum_insured": {
                            "from": 350000,
                            "to": 420000
                          },
                          "monthly_premium": {
                            "from": 1850,
                            "to": 2150
                          }
                        },
                        "endorsed_by": "underwriter-user-003",
                        "created_at": "2026-06-25T14:00:00Z"
                      },
                      "status": "success",
                      "message": "Endorsement created successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listEndorsements",
        "x-axiom-substrate-kind": "lifecycle",
        "x-axiom-substrate-id": "policy-endorsement-lifecycle",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "List policy endorsements",
        "description": "Return the policy's endorsements, ordered by version_number ascending.\nEndorsements are stored as policy version snapshots (no separate entity);\nthis list is the policy's versions filtered to version_type == endorsement.\nBacks the application Policies \u2192 Endorsements tab.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Policy endorsements retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyVersionListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/certificates/{party_id}": {
      "get": {
        "operationId": "getCertificate",
        "summary": "Get insured-party certificate projection",
        "description": "Retrieve a read-only certificate of insurance for a specific insured party on a\ngroup policy. Resolves the effective policy version and active roles at the\n`as_of` timestamp (defaults to now). Returns the master policy_id, party_id,\nrole list, effectivity window, and pinned version_id.\n\nNo persistence side effects \u2014 this is a pure read projection.\n\nReturns 404 if the party is unknown or inactive at the given `as_of` time.\n",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique policy identifier"
          },
          {
            "name": "party_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pty_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "party-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Typed-prefix identifier of the insured party"
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Point-in-time for certificate resolution (defaults to now)"
          }
        ],
        "responses": {
          "200": {
            "description": "Certificate projection retrieved",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificateResponse"
                },
                "examples": {
                  "insured_party_certificate": {
                    "summary": "Active insured-party certificate",
                    "value": {
                      "data": {
                        "policy_id": "pol_01abcdefghjkmnpqrstvwxyz01",
                        "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                        "version_id": "pov_01abcdefghjkmnpqrstvwxyz02",
                        "roles": [
                          "policyholder",
                          "insured"
                        ],
                        "effective_from": "2026-04-01T00:00:00Z",
                        "effective_to": null
                      },
                      "status": "success",
                      "message": "Certificate retrieved successfully"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/lifecycle-definitions": {
      "post": {
        "description": "Create a tenant-owned draft insurance lifecycle definition for an admitted product or business object. The server derives tenant authority from X-Tenant-Context and rejects generic workflow, BPMN, public PipelineTemplate, and raw public rule-evaluation authoring.",
        "operationId": "createLifecycleDefinition",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LifecycleDefinitionDraftRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LifecycleDefinitionResponse"
                }
              }
            },
            "description": "Lifecycle definition draft created."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "lifecycle-definitions:write"
            ]
          }
        ],
        "summary": "Create Lifecycle Definition Draft",
        "tags": [
          "Lifecycle Authoring",
          "Policy"
        ],
        "x-axiom-wire-success-profile": "json-api",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "lifecycle-definitions:write"
          ],
          "required_permissions": [
            "lifecycle-definitions:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/lifecycle-definitions/validate": {
      "post": {
        "description": "Validate an insurance lifecycle definition draft against Axiom lifecycle grammar, custody, transition, evidence, retention, and explanation rules before publication. Validation is deterministic and fails closed for generic workflow/BPMN, public PipelineTemplate, raw public rule evaluation, and caller-supplied tenant authority.",
        "operationId": "validateLifecycleDefinition",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LifecycleDefinitionValidationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LifecycleValidationResponse"
                }
              }
            },
            "description": "Lifecycle definition validation result."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "lifecycle-definitions:read"
            ]
          }
        ],
        "summary": "Validate Lifecycle Definition Draft",
        "tags": [
          "Lifecycle Authoring",
          "Policy"
        ],
        "x-axiom-wire-success-profile": "json-api",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "lifecycle-definitions:read"
          ],
          "required_permissions": [
            "lifecycle-definitions:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/lifecycle-definitions/{definition_id}/publish": {
      "post": {
        "description": "Publish a validated lifecycle definition version. Published versions are immutable, effective-time bound, and become eligible for server-side lifecycle binding resolution only after validation and publication evidence are recorded.",
        "operationId": "publishLifecycleDefinition",
        "parameters": [
          {
            "description": "Path parameter `definition_id`.",
            "in": "path",
            "name": "definition_id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^ild_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "ild_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "insurance-lifecycle-definition-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LifecycleDefinitionPublishRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LifecycleDefinitionResponse"
                }
              }
            },
            "description": "Lifecycle definition version published."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "lifecycle-definitions:publish"
            ]
          }
        ],
        "summary": "Publish Lifecycle Definition",
        "tags": [
          "Lifecycle Authoring",
          "Policy"
        ],
        "x-axiom-wire-success-profile": "json-api",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "lifecycle-definitions:publish"
          ],
          "required_permissions": [
            "lifecycle-definitions:publish"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/compliance-packs": {
      "post": {
        "description": "Create a tenant-owned compliance-pack draft that can be pinned by lifecycle definitions and bindings. The pack records jurisdiction, legal references, obligations, evidence, disclosures, time gates, retention, and activation posture without becoming code-hidden compliance behavior.",
        "operationId": "createCompliancePack",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompliancePackDraftRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompliancePackResponse"
                }
              }
            },
            "description": "Compliance pack draft created."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "compliance-packs:write"
            ]
          }
        ],
        "summary": "Create Compliance Pack Draft",
        "tags": [
          "Lifecycle Authoring",
          "Policy"
        ],
        "x-axiom-wire-success-profile": "json-api",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "compliance-packs:write"
          ],
          "required_permissions": [
            "compliance-packs:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/lifecycle-bindings": {
      "post": {
        "description": "Create an effective-time lifecycle binding from tenant/product/business-object scope to published lifecycle definition and compliance-pack versions. The server resolves tenant authority and callers cannot supply raw PipelineTemplate identifiers, raw ruleset selectors, or tenant override facts.",
        "operationId": "createLifecycleBinding",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LifecycleBindingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LifecycleBindingResponse"
                }
              }
            },
            "description": "Lifecycle binding created."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "lifecycle-bindings:write"
            ]
          }
        ],
        "summary": "Create Lifecycle Binding",
        "tags": [
          "Lifecycle Authoring",
          "Policy"
        ],
        "x-axiom-wire-success-profile": "json-api",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "lifecycle-bindings:write"
          ],
          "required_permissions": [
            "lifecycle-bindings:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims (submitClaim) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "submitClaim",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubmitClaimRequest"
              }
            },
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/SubmitClaimMultipartRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClaimResponse"
                }
              }
            },
            "description": "Retained assertion submitted successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Currency is missing, invalid, or heterogeneous; amount or lifecycle validation failed."
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:write"
            ]
          }
        ],
        "summary": "Retained Claim Compatibility Submit",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:write"
          ],
          "required_permissions": [
            "claims:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "multipart-form-data",
            "parse_memory_bytes": 33554432,
            "numeric_request_byte_limit": 67108864,
            "file_count_limit": 10,
            "enforcement": "runtime"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "deprecated": true,
        "description": "Compatibility contract for retained GET /v1/claims (listClaims) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "listClaims",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Page size; defaults to 20 and must be between 1 and 100.",
            "in": "query",
            "name": "page[size]",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Opaque cursor returned as meta.next_cursor by the previous page.",
            "in": "query",
            "name": "page[after]",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by canonical typed-prefix policy identifier.",
            "in": "query",
            "name": "policy_id",
            "required": false,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Filter by canonical typed-prefix primary-party identifier.",
            "in": "query",
            "name": "party_id",
            "required": false,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "pty_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "party-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClaimListResponse"
                }
              }
            },
            "description": "Cursor-paginated retained assertions."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:read"
            ]
          }
        ],
        "summary": "Retained Claim Compatibility List",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "policy_id",
            "party_id"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:read"
          ],
          "required_permissions": [
            "claims:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}": {
      "get": {
        "deprecated": true,
        "description": "Compatibility contract for retained GET /v1/claims/{id} (getClaim) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "getClaim",
        "parameters": [
          {
            "description": "Path parameter `id`.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:read"
            ]
          }
        ],
        "summary": "Retained Claim Compatibility Get",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:read"
          ],
          "required_permissions": [
            "claims:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-nonread",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/assess": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{id}/assess (assessClaim) in the Events/Assertions portfolio. Axiom canon is events/assertions; the route assesses the contract-facing assertion for the retained claim-family surface. Claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "assessClaim",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssessClaimRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssessClaimResponse"
                }
              }
            },
            "description": "Retained assertion assessed successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:write"
            ]
          }
        ],
        "summary": "Retained Claim Compatibility Assess",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "pipeline",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-pipeline-contract": "docs/product/events-assertions-assessment-pipeline-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:write"
          ],
          "required_permissions": [
            "claims:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/authorisations": {
      "post": {
        "operationId": "recordClaimAuthorisation",
        "deprecated": true,
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Record retained claim-family authorisation",
        "description": "Record an governed contract authorisation sub-event against the retained\nclaim-family compatibility surface. Axiom canon is events/assertions; the\nauthorisation row is append-only and carries the authorising actor,\nauthorised scope, budget, governing-version binding, optional compliance\nstate, decision date, and explanation-node reference.\n\nPayment operations may cite the returned authorisation id. When they do, the\npayment path runs the authorisation compliance gate before disbursement.\n\nSide effects: persists an `authorisation_transitions` row under the\ntenant context and returns the recorded authorisation.\n",
        "tags": [
          "Claim"
        ],
        "security": [
          {
            "BearerAuth": [
              "claims:authorise"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique retained claim-family compatibility identifier."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RecordClaimAuthorisationRequest"
              },
              "examples": {
                "medical_pre_auth": {
                  "summary": "Medical service authorisation",
                  "value": {
                    "transition_kind": "authorisation-granted",
                    "authorisation_kind": "pre-auth",
                    "authorising_actor": "rol_01arz3ndektsv4rrffq69g5fav",
                    "authorised_scope": {
                      "procedure_code": "1234",
                      "visit_limit": 3
                    },
                    "budget_minor": 250000,
                    "budget_currency_code": "zar",
                    "governing_version_kind": "catalogue",
                    "governing_version_row_id": "governance_version_20260408_0001",
                    "decision_date": "2026-07-06T10:00:00Z",
                    "explanation_node_id": "een_01arz3ndektsv4rrffq69g5fav"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Claim authorisation recorded successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RecordClaimAuthorisationResponse"
                },
                "examples": {
                  "recorded": {
                    "summary": "Recorded authorisation",
                    "value": {
                      "data": {
                        "id": "atr_01arz3ndektsv4rrffq69g5fav",
                        "logical_authorisation_id": "authz_logical_20260408_0001",
                        "entity_type": "claim",
                        "entity_id": "clm_01arz3ndektsv4rrffq69g5fav",
                        "transition_kind": "authorisation-granted",
                        "authorisation_kind": "pre-auth",
                        "authorising_actor": "rol_01arz3ndektsv4rrffq69g5fav",
                        "authorised_scope": {
                          "procedure_code": "1234",
                          "visit_limit": 3
                        },
                        "budget_minor": 250000,
                        "budget_currency_code": "zar",
                        "decision_date": "2026-07-06T10:00:00Z",
                        "explanation_node_id": "een_01arz3ndektsv4rrffq69g5fav",
                        "valid_from": "2026-07-06T10:00:00Z",
                        "asserted_from": "2026-07-06T10:00:00Z"
                      },
                      "status": "success",
                      "message": "Claim authorisation recorded successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:authorise"
          ],
          "required_permissions": [
            "claims:authorise"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/pay": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{id}/pay (payClaim) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "payClaim",
        "parameters": [
          {
            "description": "Path parameter `id`.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PayClaimRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayClaimResponse"
                }
              }
            },
            "description": "Payment processed successfully"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Payment currency differs from the authoritative aggregate or settlement currency, or another payment validation failed."
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:pay"
            ]
          }
        ],
        "summary": "Retained Claim Compatibility Pay",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:pay"
          ],
          "required_permissions": [
            "claims:pay"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/close": {
      "post": {
        "operationId": "closeClaim",
        "deprecated": true,
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Close retained claim-family resource",
        "description": "Close a retained claim-family compatibility resource through the runtime\nservice. The handler enforces tenant context, typed compatibility IDs,\nactor attribution, and terminal-state transition checks before recording\nthe closure.\n",
        "tags": [
          "Claim"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique retained claim-family compatibility identifier."
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "closure_reason": {
                    "type": "string",
                    "description": "Reason for closing the retained compatibility resource.",
                    "example": "Final settlement disbursed and accepted by claimant"
                  },
                  "closed_by": {
                    "type": "string",
                    "description": "Identifier of the user or system closing the retained compatibility resource.",
                    "example": "claims-manager-001"
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "paid_closure": {
                  "summary": "Close after payment",
                  "value": {
                    "closure_reason": "Final settlement disbursed and accepted by claimant",
                    "closed_by": "claims-manager-001"
                  }
                },
                "withdrawn": {
                  "summary": "Close due to withdrawal",
                  "value": {
                    "closure_reason": "Claimant withdrew the claim on 2026-03-10",
                    "closed_by": "claims-officer-015"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Retained compatibility resource closed successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClaimResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Retained compatibility resource not in a closeable state (INVALID_STATE_TRANSITION)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "INVALID_STATE_TRANSITION",
                      "title": "Validation Error",
                      "detail": "Retained compatibility resource cannot perform close from status submitted"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/pdf": {
      "get": {
        "operationId": "generateClaimPDF",
        "deprecated": true,
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Generate retained claim-family PDF report",
        "description": "Generate a PDF document summarising the retained claim-family\ncompatibility resource, including event details, assessment results,\npayment information, and lifecycle history.\n\nThe PDF is generated on demand and returned as a binary response. For large\nretained resources with extensive documentation, generation may take\nseveral seconds.\n\nThe generated PDF includes:\n- Retained compatibility header (claim number, policy number, status)\n- Event details and description\n- Retained line items with amounts\n- Assessment summary and notes\n- Payment details (if applicable)\n- Lifecycle timeline\n\nThis endpoint returns binary PDF data (application/pdf), not a JSON envelope.\n",
        "tags": [
          "Claim"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique retained claim-family compatibility identifier."
          },
          {
            "name": "party_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pty_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "party-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Optional party access check for the generated claim report. When present,\nmust be the canonical typed-prefix party id (`pty_...`) for the retained\ncompatibility resource's primary party.\n"
          }
        ],
        "responses": {
          "200": {
            "description": "PDF generated successfully",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Content-Disposition": {
                "description": "Suggested filename for the downloaded PDF",
                "schema": {
                  "type": "string",
                  "example": "attachment; filename=\"CLM-2026-00042.pdf\""
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "party_id"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/reserves": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{id}/reserves (createReserve) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "createReserve",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateReserveRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReserveResponse"
                }
              }
            },
            "description": "Reserve created successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:reserve"
            ]
          }
        ],
        "summary": "Create Reserve",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:reserve"
          ],
          "required_permissions": [
            "claims:reserve"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "deprecated": true,
        "description": "Compatibility contract for retained GET /v1/claims/{id}/reserves (listClaimReserves) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "listClaimReserves",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReserveListResponse"
                }
              }
            },
            "description": "Reserves retrieved successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Reserve authority required (RESERVE_AUTHORITY_REQUIRED)."
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:read"
            ]
          }
        ],
        "summary": "Retained Claim Compatibility Reserve List",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:read"
          ],
          "required_permissions": [
            "claims:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/reserves/{reserveId}": {
      "get": {
        "deprecated": true,
        "description": "Compatibility contract for retained GET /v1/claims/{id}/reserves/{reserveId} (getReserve) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "getReserve",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "ClaimReserve id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clr_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "reserveId",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clr_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReserveResponse"
                }
              }
            },
            "description": "Reserve retrieved successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Reserve authority required (RESERVE_AUTHORITY_REQUIRED)."
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:read"
            ]
          }
        ],
        "summary": "Get Reserve",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:read"
          ],
          "required_permissions": [
            "claims:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "patch": {
        "deprecated": true,
        "description": "Compatibility contract for retained PATCH /v1/claims/{id}/reserves/{reserveId} (updateReserve) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "updateReserve",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "ClaimReserve id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clr_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "reserveId",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clr_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateReserveRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReserveResponse"
                }
              }
            },
            "description": "Reserve updated successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:reserve"
            ]
          }
        ],
        "summary": "Update Reserve",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:reserve"
          ],
          "required_permissions": [
            "claims:reserve"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/reserves/{reserveId}/release": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{id}/reserves/{reserveId}/release (releaseReserve) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "releaseReserve",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "ClaimReserve id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clr_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "reserveId",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clr_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReleaseReserveRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReserveResponse"
                }
              }
            },
            "description": "Reserve amount released successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:reserve"
            ]
          }
        ],
        "summary": "Release Reserve",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:reserve"
          ],
          "required_permissions": [
            "claims:reserve"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/reserves/{reserveId}/cancel": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{id}/reserves/{reserveId}/cancel (cancelReserve) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "cancelReserve",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "ClaimReserve id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clr_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "reserveId",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clr_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelReserveRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReserveResponse"
                }
              }
            },
            "description": "Reserve cancelled successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:reserve"
            ]
          }
        ],
        "summary": "Cancel Reserve",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:reserve"
          ],
          "required_permissions": [
            "claims:reserve"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/reserves/{reserveId}/reestablish": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{id}/reserves/{reserveId}/reestablish (reestablishReserve) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "reestablishReserve",
        "parameters": [
          {
            "description": "Claim id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "ClaimReserve id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "clr_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "reserveId",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^clr_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReestablishReserveRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReestablishReserveResponse"
                }
              }
            },
            "description": "Reserve re-established successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:reserve"
            ]
          }
        ],
        "summary": "Reestablish Reserve",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:reserve"
          ],
          "required_permissions": [
            "claims:reserve"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/reserves": {
      "get": {
        "deprecated": true,
        "description": "Compatibility contract for retained GET /v1/claims/reserves (listPolicyReserves) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "listPolicyReserves",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Policy identifier whose reserves are listed.",
            "in": "query",
            "name": "policy_id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "minLength": 1,
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "When true, return only active reserves; accepted values are true and false.",
            "in": "query",
            "name": "active_only",
            "required": false,
            "schema": {
              "default": false,
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReserveListResponse"
                }
              }
            },
            "description": "Reserves retrieved successfully."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Reserve authority required (RESERVE_AUTHORITY_REQUIRED)."
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:read"
            ]
          }
        ],
        "summary": "List Policy Reserves",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "policy_id",
            "active_only"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:read"
          ],
          "required_permissions": [
            "claims:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/investigations": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{id}/investigations (createOrAdvanceInvestigation) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "createOrAdvanceInvestigation",
        "parameters": [
          {
            "description": "Path parameter `id`.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:investigate"
            ]
          }
        ],
        "summary": "Create Or Advance Investigation",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:investigate"
          ],
          "required_permissions": [
            "claims:investigate"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{claimId}/recoveries": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{claimId}/recoveries (createRecovery) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "createRecovery",
        "parameters": [
          {
            "description": "Path parameter `claimId`.",
            "in": "path",
            "name": "claimId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:recover"
            ]
          }
        ],
        "summary": "Create Recovery",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:recover"
          ],
          "required_permissions": [
            "claims:recover"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{claimId}/recoveries/{recoveryId}/corrections": {
      "post": {
        "deprecated": true,
        "description": "Compatibility contract for retained POST /v1/claims/{claimId}/recoveries/{recoveryId}/corrections (createCorrection) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "createCorrection",
        "parameters": [
          {
            "description": "Path parameter `claimId`.",
            "in": "path",
            "name": "claimId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Path parameter `recoveryId`.",
            "in": "path",
            "name": "recoveryId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:recover"
            ]
          }
        ],
        "summary": "Create Correction",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "workflow",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:recover"
          ],
          "required_permissions": [
            "claims:recover"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/settlement-statements/{decisionId}": {
      "get": {
        "deprecated": true,
        "description": "Compatibility contract for retained GET /v1/claims/{id}/settlement-statements/{decisionId} (getClaimSettlementStatement) in the Events/Assertions portfolio. Axiom canon is events/assertions; claim-family route names, operationIds, permission scopes, generated filenames, and SDK-facing identifiers are retained compatibility identifiers until a governed migration. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "getClaimSettlementStatement",
        "parameters": [
          {
            "description": "Path parameter `id`.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "clm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "claim-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Path parameter `decisionId`.",
            "in": "path",
            "name": "decisionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:read"
            ]
          }
        ],
        "summary": "Retained Claim Compatibility Get Settlement Statement",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:read"
          ],
          "required_permissions": [
            "claims:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-nonread",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/assertions": {
      "post": {
        "description": "Create a first-class assertion as the contract-response half of the events/assertions paired primitive. The caller supplies the event identity, rule version, assertion label identity, payload, and explicit bitemporal axes; Axiom mints the physical assertion identity and deterministic logical assertion thread.",
        "operationId": "createAssertion",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "assertions:write"
            ]
          }
        ],
        "summary": "Create Assertion",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "assertions:write"
          ],
          "required_permissions": [
            "assertions:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "description": "Contract authority for GET /v1/assertions (listAssertions) in the Events/Assertions portfolio. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "listAssertions",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "assertions:read"
            ]
          }
        ],
        "summary": "List Assertions",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "assertions:read"
          ],
          "required_permissions": [
            "assertions:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-nonread",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/assertions/{id}": {
      "get": {
        "description": "Contract authority for GET /v1/assertions/{id} (getAssertion) in the Events/Assertions portfolio. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "getAssertion",
        "parameters": [
          {
            "description": "Path parameter `id`.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^ass_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "ass_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "assertion-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "assertions:read"
            ]
          }
        ],
        "summary": "Get Assertion",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "assertions:read"
          ],
          "required_permissions": [
            "assertions:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-nonread",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/assertions/{id}/assessment/verify-replay": {
      "post": {
        "description": "Strictly replays the pipeline execution an assessment assertion records (governed contract decision-to-execution binding; governed contract strict replay). The assertion names the semantic fingerprint of its execution; resolution is bound to the record the assertion's deterministic logical thread and event identify, never trusted from the payload. The retained execution is re-executed from its frozen inputs with the retained template version and the as-was policy version and product. Returns verified, or diverged with the divergence kind (execution fingerprint, or an assertion that does not record the replayed outcome and amount), with both explanation roots and the stored and re-derived contract responses. A non-binding check: it never re-adjudicates. Writes no assessment, evidence, snapshot, assertion or status.",
        "operationId": "verifyAssertionAssessmentReplay",
        "parameters": [
          {
            "description": "Assertion id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "ass_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^ass_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssertionAssessmentReplayVerificationResponse"
                }
              }
            },
            "description": "Replay outcome, verified or diverged, with both explanation roots."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "claims:assess"
            ]
          }
        ],
        "summary": "Verify an assessment assertion by strict replay",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "claims:assess"
          ],
          "required_permissions": [
            "claims:assess"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/premiums": {
      "get": {
        "operationId": "listPremiums",
        "summary": "List premiums",
        "description": "Retrieve a paginated list of aggregate premium records for the operating\ntenant (one Premium per policy, the contract model). Cursor-paginated with\n`page[size]` default 20 / max 100 and opaque `page[after]` cursors.\nLegacy `limit` and `offset` query parameters are rejected.\n\nThe `policy_id` / `party_id` filter parameters are validated fail-loud (a\nmalformed typed-prefix value returns `400`, governed contract); they compose with the\noperating-tenant tenant-isolated scope, never widen it.\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of premiums to return in this cursor page"
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor returned as meta.next_cursor by the previous page"
          },
          {
            "name": "policy_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Optional filter \u2014 return only premiums for this policy.\nAccepts the canonical typed-prefix policy id (`pol_\u2026`, governed contract).\nA malformed value returns 400. Absent = all premiums for the tenant.\nComposes with the existing operating-tenant tenant-isolated scope; never widens it.\n"
          },
          {
            "name": "party_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pty_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "party-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Optional filter \u2014 return only premiums owed by this party (the premium\ndebtor / policyholder). Accepts the canonical typed-prefix party id\n(`pty_\u2026`, governed contract). A malformed value returns 400. Absent = all\npremiums for the tenant. Composes with the existing operating-tenant\ntenant-isolated scope; never widens it.\n"
          }
        ],
        "responses": {
          "200": {
            "description": "Premiums retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PremiumListResponse"
                },
                "examples": {
                  "premium_list": {
                    "summary": "Aggregate premiums across policies",
                    "value": {
                      "data": [
                        {
                          "id": "prm_01abcdefghjkmnpqrstvwxyz01",
                          "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                          "premium_type": "initial",
                          "status": "active",
                          "currency": "zar",
                          "base_premium": 125000,
                          "total_discount": 0,
                          "total_surcharge": 0,
                          "tax_amount": 0,
                          "net_premium": 125000,
                          "final_premium": 125000,
                          "installment_count": 12,
                          "installment_amount_minor": 10417,
                          "payment_frequency": "monthly",
                          "effective_date": "2026-01-01T00:00:00Z",
                          "created_at": "2026-01-01T00:00:00Z",
                          "updated_at": "2026-01-01T00:00:00Z"
                        },
                        {
                          "id": "prm_01abcdefghjkmnpqrstvwxyz01",
                          "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                          "premium_type": "renewal",
                          "status": "draft",
                          "currency": "gbp",
                          "base_premium": 9550,
                          "total_discount": 0,
                          "total_surcharge": 0,
                          "tax_amount": 0,
                          "net_premium": 9550,
                          "final_premium": 9550,
                          "installment_count": 1,
                          "installment_amount_minor": 9550,
                          "payment_frequency": "annual",
                          "effective_date": "2026-02-15T00:00:00Z",
                          "created_at": "2026-01-15T00:00:00Z",
                          "updated_at": "2026-01-15T00:00:00Z"
                        }
                      ],
                      "meta": {
                        "page_size": 20,
                        "has_more": false
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "policy_id",
            "party_id"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createPremium",
        "summary": "Create a premium record",
        "description": "Persist a new aggregate premium (inflow-obligation) record for a policy and\nreturn it with `201 Created`. Exactly one Premium exists per policy\n(the (tenant context, policy_id) uniqueness constraint, the contract model) \u2014 a create for a policy\nthat already has a premium fails loud with `409 Conflict`.\n\nThis persists a manually-entered / imported inflow-obligation record at\n`status=draft`. It is NOT a rated premium decision \u2014 the rated path is\n`POST /v1/premiums/calculate`, which evaluates versioned CEL rules and emits\nan explanation tree. A draft obligation carries no rating decision to\nexplain (platform principle untouched).\n\nThe premium is scoped to the operating tenant \u2014 `tenant context` is taken from the\ntenant-context, never the request body. Intentional defaults applied on\ncreate (documented, not silent): `status=draft`, `premium_type` defaults to\n`initial`, and an unrated draft sets `base_premium = net_premium =\nfinal_premium = amount.amount_minor` (no discounts/commission yet, contract rule).\n\nIdempotent via the `Idempotency-Key` header: same key + same body returns the\noriginal `201`; same key + different body returns `409`.\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "policy_id",
                  "amount"
                ],
                "properties": {
                  "policy_id": {
                    "type": "string",
                    "description": "Reference to the policy this premium belongs to, in the canonical\ntyped-prefix form (`pol_\u2026`, governed contract). A malformed\ntyped identifier returns 400.\n",
                    "example": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "format": "typed-prefix-id",
                    "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
                    "x-axiom-identifier-classification": "policy-id",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "amount": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/Money"
                      }
                    ],
                    "description": "Premium amount (exact integer minor units + lowercase ISO-4217 currency code). Must be non-empty."
                  },
                  "premium_type": {
                    "type": "string",
                    "description": "Optional classifier on the aggregate premium (defaults to\n`initial` when omitted, contract rule). E.g. `initial`, `renewal`,\n`endorsement`, `adjustment`.\n",
                    "example": "initial"
                  },
                  "party_id": {
                    "type": "string",
                    "description": "Optional reference to the party who owes this premium, in the\ncanonical typed-prefix form (`pty_\u2026`, governed contract). A malformed\ntyped identifier returns 400.\n",
                    "example": "pty_01h9xg2c7e8f4a5b6c7d8e9f0a",
                    "format": "typed-prefix-id",
                    "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
                    "x-axiom-identifier-classification": "party-id",
                    "x-axiom-identifier-shape": "typed-prefix"
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "monthly_debit_order": {
                  "summary": "Draft inflow obligation (ZAR)",
                  "value": {
                    "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "amount": {
                      "amount_minor": 125000,
                      "currency_code": "zar"
                    },
                    "premium_type": "initial"
                  }
                },
                "endorsement_adjustment": {
                  "summary": "Endorsement premium adjustment (UK)",
                  "value": {
                    "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "amount": {
                      "amount_minor": 2250,
                      "currency_code": "gbp"
                    },
                    "premium_type": "endorsement"
                  }
                },
                "with_party": {
                  "summary": "Annual premium with explicit debtor party (Japan)",
                  "value": {
                    "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "amount": {
                      "amount_minor": 48000000,
                      "currency_code": "jpy"
                    },
                    "premium_type": "renewal",
                    "party_id": "pty_01h9xg2c7e8f4a5b6c7d8e9f0a"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Premium created and persisted successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PremiumResponse"
                },
                "examples": {
                  "premium_created": {
                    "summary": "Draft premium created",
                    "value": {
                      "data": {
                        "id": "prm_01abcdefghjkmnpqrstvwxyz01",
                        "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                        "premium_type": "initial",
                        "status": "draft",
                        "currency": "zar",
                        "base_premium": 125000,
                        "total_discount": 0,
                        "total_surcharge": 0,
                        "tax_amount": 0,
                        "net_premium": 125000,
                        "final_premium": 125000,
                        "installment_count": 1,
                        "installment_amount_minor": 125000,
                        "payment_frequency": "annual",
                        "effective_date": "2026-03-12T08:00:00Z",
                        "created_at": "2026-03-12T08:00:00Z",
                        "updated_at": "2026-03-12T08:00:00Z"
                      },
                      "status": "success",
                      "message": "Premium created successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/premiums/{id}": {
      "get": {
        "operationId": "getPremium",
        "summary": "Get a premium by ID",
        "description": "Retrieve a single premium record by its unique identifier.\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "prm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "premium-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique premium identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Premium retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PremiumResponse"
                },
                "examples": {
                  "active_premium": {
                    "summary": "Active aggregate premium",
                    "value": {
                      "data": {
                        "id": "prm_01abcdefghjkmnpqrstvwxyz01",
                        "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                        "party_id": "pty_01h9xg2c7e8f4a5b6c7d8e9f0a",
                        "premium_type": "initial",
                        "status": "active",
                        "currency": "zar",
                        "base_premium": 125000,
                        "total_discount": 0,
                        "total_surcharge": 0,
                        "tax_amount": 0,
                        "net_premium": 125000,
                        "final_premium": 125000,
                        "installment_count": 12,
                        "installment_amount_minor": 10417,
                        "payment_frequency": "monthly",
                        "effective_date": "2026-01-01T00:00:00Z",
                        "due_date": "2026-04-01T00:00:00Z",
                        "created_at": "2026-01-01T00:00:00Z",
                        "updated_at": "2026-03-02T08:30:00Z"
                      },
                      "status": "success"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/premiums/calculate": {
      "post": {
        "operationId": "calculatePremium",
        "x-axiom-substrate-kind": "pipeline",
        "x-axiom-substrate-id": "premium-quotation-evaluation",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Calculate a premium quotation",
        "description": "Calculate a premium quotation for a given product and rating profile. This is a\nread-only operation that does not create any records -- it returns the calculated\npremium breakdown including base premium, adjustments, commissions, and totals.\n\nThe calculation uses the product's configured pricing rules and evaluates them\nagainst the provided rating factors. Each adjustment is itemised with the rule\nname and human-readable explanation for full transparency.\n\nOn the CEL pricing path (triggered by `effective_date` in rating_inputs), commission\nis derived from versioned CEL rules classified as `entity_type=pricing` and\n`rule_type=commission_rate` within the same ruleset binding. When no commission rule\nexists for the resolved product and effective date, commission is zero and the\ncommissions list is empty; legacy product JSON is not consulted. Commission amounts\nare exact `int64` minor units; float outputs are rejected.\n\nThis endpoint supports quote journeys where the premium is calculated before\na policy is issued.\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "policy_id",
                  "product_id",
                  "rating_inputs"
                ],
                "properties": {
                  "policy_id": {
                    "type": "string",
                    "description": "Reference to the policy being priced. Required for CEL context assembly.",
                    "example": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "format": "typed-prefix-id",
                    "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
                    "x-axiom-identifier-classification": "policy-id",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "product_id": {
                    "type": "string",
                    "description": "Reference to the product to calculate premium for",
                    "example": "prm_01abcdefghjkmnpqrstvwxyz01",
                    "format": "typed-prefix-id",
                    "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
                    "x-axiom-identifier-classification": "product-id",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "rating_inputs": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Rating inputs for premium calculation. When `effective_date` is present\n(RFC3339 format), the CEL-based pricing path is used with as-was binding\nresolution. Without `effective_date`, the legacy pricing path applies.\n",
                    "properties": {
                      "effective_date": {
                        "type": "string",
                        "format": "date-time",
                        "description": "As-was timestamp for binding resolution (RFC3339). Required for CEL path.\nWhen present, triggers CEL-based premium calculation with versioned\nruleset resolution under the governed contract.\n",
                        "example": "2026-04-01T00:00:00Z"
                      },
                      "risk_profile": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "Risk profile data for CEL evaluation (varies by product type)"
                      }
                    },
                    "example": {
                      "effective_date": "2026-04-01T00:00:00Z",
                      "risk_profile": {
                        "driver_age": 28,
                        "vehicle_value": 350000,
                        "prior_events_count": 0
                      }
                    }
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "motor_quote_cel": {
                  "summary": "Motor TPL premium calculation (CEL path)",
                  "value": {
                    "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                    "rating_inputs": {
                      "effective_date": "2026-04-01T00:00:00Z",
                      "risk_profile": {
                        "driver_age": 28,
                        "vehicle_value": 350000,
                        "vehicle_make": "Volkswagen",
                        "vehicle_model": "Polo",
                        "vehicle_year": 2023,
                        "prior_events_count": 0,
                        "event_free_years": 3,
                        "state": "New York",
                        "parking_type": "secure_garage"
                      }
                    }
                  }
                },
                "health_quote_cel": {
                  "summary": "Health cover premium calculation (CEL path)",
                  "value": {
                    "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                    "rating_inputs": {
                      "effective_date": "2026-05-01T00:00:00Z",
                      "risk_profile": {
                        "primary_age": 35,
                        "dependents": 2,
                        "dependent_ages": [
                          32,
                          5
                        ],
                        "smoker": false,
                        "plan_level": "comprehensive"
                      }
                    }
                  }
                },
                "legacy_quote": {
                  "summary": "Legacy premium calculation (no effective_date)",
                  "value": {
                    "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                    "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                    "rating_inputs": {
                      "driver_age": 35,
                      "vehicle_value": 200000
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Premium calculated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PremiumCalculationResponse"
                },
                "examples": {
                  "motor_calculation": {
                    "summary": "Motor premium breakdown",
                    "value": {
                      "data": {
                        "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                        "base_premium": {
                          "amount_minor": 1200000,
                          "currency_code": "usd"
                        },
                        "total_premium": {
                          "amount_minor": 1380000,
                          "currency_code": "usd"
                        },
                        "gross_premium": {
                          "amount_minor": 1380000,
                          "currency_code": "usd"
                        },
                        "discount_total": {
                          "amount_minor": 0,
                          "currency_code": "usd"
                        },
                        "net_premium": {
                          "amount_minor": 1380000,
                          "currency_code": "usd"
                        },
                        "adjusted_premium": {
                          "amount_minor": 1380000,
                          "currency_code": "usd"
                        },
                        "final_premium": {
                          "amount_minor": 1380000,
                          "currency_code": "usd"
                        },
                        "adjustments": [
                          {
                            "rule_name": "young_driver_loading",
                            "adjustment": 180000,
                            "description": "Young driver loading \u2014 primary driver age 28, 15% applied to base premium"
                          },
                          {
                            "rule_name": "event_free_discount",
                            "adjustment": -120000,
                            "description": "Event-free rating discount \u2014 3 event-free years, 10% discount applied"
                          },
                          {
                            "rule_name": "urban_risk_loading",
                            "adjustment": 120000,
                            "description": "Geographical risk loading \u2014 New York state, 10% applied"
                          }
                        ],
                        "discounts": [],
                        "commissions": [
                          {
                            "role_type": "broker",
                            "amount": 207000,
                            "commission_type": "initial"
                          }
                        ],
                        "calculated_at": "2026-03-12T08:00:00Z"
                      },
                      "status": "success",
                      "message": "Premium calculated successfully"
                    }
                  },
                  "health_with_discount": {
                    "summary": "Health premium with group discount",
                    "value": {
                      "data": {
                        "product_id": "prd_01abcdefghjkmnpqrstvwxyz01",
                        "base_premium": {
                          "amount_minor": 350000,
                          "currency_code": "usd"
                        },
                        "total_premium": {
                          "amount_minor": 595000,
                          "currency_code": "usd"
                        },
                        "gross_premium": {
                          "amount_minor": 595000,
                          "currency_code": "usd"
                        },
                        "discount_total": {
                          "amount_minor": 29750,
                          "currency_code": "usd"
                        },
                        "net_premium": {
                          "amount_minor": 565250,
                          "currency_code": "usd"
                        },
                        "adjusted_premium": {
                          "amount_minor": 595000,
                          "currency_code": "usd"
                        },
                        "final_premium": {
                          "amount_minor": 565250,
                          "currency_code": "usd"
                        },
                        "adjustments": [
                          {
                            "rule_name": "dependent_loading",
                            "adjustment": 210000,
                            "description": "Dependent loading \u2014 1 adult dependent (140000 cents) + 1 child dependent (70000 cents)"
                          },
                          {
                            "rule_name": "non_smoker_discount",
                            "adjustment": -35000,
                            "description": "Non-smoker discount \u2014 10% applied to primary policyholder base"
                          },
                          {
                            "rule_name": "age_band_adjustment",
                            "adjustment": 70000,
                            "description": "Age band 30-39 \u2014 20% loading on base premium"
                          }
                        ],
                        "discounts": [
                          {
                            "group_id": "grp-family-001",
                            "rule_id": "rul_01abcdefghjkmnpqrstvwxyz01",
                            "rule_version": 1,
                            "amount": 29750,
                            "composition_included": true,
                            "description": "Group discount: Family Plan (rule rul_01abcdefghjkmnpqrstvwxyz01 v1)"
                          }
                        ],
                        "commissions": [
                          {
                            "role_type": "broker",
                            "amount": 59500,
                            "commission_type": "initial"
                          }
                        ],
                        "calculated_at": "2026-03-12T08:00:00Z"
                      },
                      "status": "success",
                      "message": "Premium calculated successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "description": "Actor attribution is missing or invalid. Premium calculation requires\nan authenticated actor and tenant context before a rated decision can\nbe evaluated.\n",
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Validation error from CEL premium calculation path. Possible error codes:\n- `EFFECTIVE_DATE_REQUIRED` \u2014 `rating_inputs.effective_date` is missing\n- `EFFECTIVE_DATE_INVALID` \u2014 `rating_inputs.effective_date` is not valid RFC3339\n- `PRICING_RULESET_NOT_FOUND_AS_OF` \u2014 no active pricing ruleset at `effective_date`\n- `RULE_CONTEXT_MISSING` \u2014 required evaluation fact is absent\n- `PREMIUM_RULE_OUTPUT_INVALID` \u2014 CEL rule returned non-exact financial output\n- `PREMIUM_CEL_DEPS_MISSING` \u2014 CEL pipeline dependencies not configured\n- `GROUP_DISCOUNT_OUTPUT_INVALID` \u2014 group discount rule returned float, negative, or malformed output\n- `DISCOUNT_COMPOSITION_REQUIRED` \u2014 no tenant or system discount composition rule found\n- `DISCOUNT_COMPOSITION_INVALID` \u2014 composition rule returned unsupported mode or negative result\n- `DISCOUNT_TOTAL_EXCEEDS_GROSS` \u2014 composed discount total exceeds gross premium\n- `BILLING_PERIOD_ANCHOR_REQUIRED` \u2014 forward-only enforcement cannot resolve next billing anchor\n- `COMMISSION_PARTICIPANT_REQUIRED` \u2014 distribution chain empty, no participants for split\n- `COMMISSION_SPLIT_RULE_OUTPUT_INVALID` \u2014 split rule returned unknown parties, negative/zero shares, or malformed output\n- `COMMISSION_SPLIT_UNBALANCED` \u2014 split shares sum does not equal total commission\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "effective_date_required": {
                    "summary": "Missing effective_date",
                    "value": {
                      "errors": [
                        {
                          "status": "422",
                          "code": "EFFECTIVE_DATE_REQUIRED",
                          "title": "Validation Error",
                          "detail": "effective_date is required for premium calculation under the governed contract"
                        }
                      ]
                    }
                  },
                  "effective_date_invalid": {
                    "summary": "Invalid effective_date format",
                    "value": {
                      "errors": [
                        {
                          "status": "422",
                          "code": "EFFECTIVE_DATE_INVALID",
                          "title": "Validation Error",
                          "detail": "effective_date is not valid RFC3339: parsing time \"not-a-date\""
                        }
                      ]
                    }
                  },
                  "ruleset_not_found": {
                    "summary": "No pricing ruleset at effective_date",
                    "value": {
                      "errors": [
                        {
                          "status": "422",
                          "code": "PRICING_RULESET_NOT_FOUND_AS_OF",
                          "title": "Validation Error",
                          "detail": "no active pricing ruleset at requested effective_date"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Service error from premium calculation. Internal failures are returned\nthrough the standard error envelope without exposing infrastructure\ndetails to public clients.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "service_error": {
                    "summary": "Internal calculation failure",
                    "value": {
                      "errors": [
                        {
                          "status": "500",
                          "code": "SERVER_ERROR",
                          "title": "Server Error",
                          "detail": "Failed to calculate premium"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/premiums/{id}/cancellation-refunds": {
      "post": {
        "operationId": "postPremiumCancellationRefund",
        "summary": "Post a balanced premium cancellation refund",
        "description": "Computes the cancellation return-premium for the supplied policy/event using\nthe as-was product ruleset binding (governed contract). Non-zero refunds post a\nbalanced `premium_refund` ledger transaction (governed contract) \u2014 one\ndebit against `premium-income` and one credit against\n`premium-refund-payable`. Zero-refund decisions persist an explanation tree\nand return an empty ledger entry list without fabricating ledger rows. The\nrefund amount is calculated by the configured method on the binding:\n`pro_rata`, `short_rate`, or `minimum_earned`. All amounts are exact int64\nminor units; basis points are int64 (governed contract).\n\nThe same call durably persists an AC-7 explanation tree (governed contract). For\nnon-zero refunds the tree is persisted in the same transaction as\nthe ledger entries; the persisted tree's ID is stamped on both ledger legs\nas `explanation_tree_id`.\n\nIdempotency is keyed strictly on the client-supplied `Idempotency-Key`\nheader (governed contract). Replays return `200 OK` with `is_replay=true` and the\noriginal transaction's ledger entry IDs; first-posts return `201 Created`.\nAn empty `Idempotency-Key` returns 422 `IDEMPOTENCY_KEY_REQUIRED`.\n\nCancellation return premium (pro-rata, short-rate, minimum-earned).\nAll required inputs and\nconfiguration must be present and well-formed; missing or malformed\ncancellation_refund.* keys surface as typed 422 errors with stable codes.\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "prm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "premium-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique premium identifier"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "description": "Client-supplied idempotency key (governed contract). Required. The server\nderives the per-leg ledger row keys as `{Idempotency-Key}:debit` and\n`{Idempotency-Key}:credit`. Replays of the same key return the\noriginal transaction with `is_replay=true` and write no new rows.\n"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/vnd.api+json": {
              "schema": {
                "type": "object",
                "required": [
                  "data"
                ],
                "properties": {
                  "data": {
                    "type": "object",
                    "required": [
                      "type",
                      "attributes"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "premium-cancellation-refunds"
                        ]
                      },
                      "attributes": {
                        "type": "object",
                        "required": [
                          "policy_id",
                          "product_id",
                          "cancellation_event_id",
                          "cancellation_date",
                          "coverage_start",
                          "coverage_end",
                          "refund_beneficiary_party_id"
                        ],
                        "properties": {
                          "policy_id": {
                            "type": "string",
                            "description": "Identifier of the policy being cancelled.",
                            "format": "typed-prefix-id",
                            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
                            "example": "pol_01arz3ndektsv4rrffq69g5fav",
                            "x-axiom-identifier-classification": "policy-id",
                            "x-axiom-identifier-shape": "typed-prefix"
                          },
                          "product_id": {
                            "type": "string",
                            "description": "Identifier of the product whose ruleset binding governs refund method/config.",
                            "format": "typed-prefix-id",
                            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
                            "example": "prd_01arz3ndektsv4rrffq69g5fav",
                            "x-axiom-identifier-classification": "product-id",
                            "x-axiom-identifier-shape": "typed-prefix"
                          },
                          "cancellation_event_id": {
                            "type": "string",
                            "description": "Stable identifier of the cancellation event being settled.",
                            "x-axiom-identifier-classification": "event-id",
                            "x-axiom-identifier-shape": "opaque-string"
                          },
                          "cancellation_date": {
                            "type": "string",
                            "format": "date-time",
                            "description": "RFC3339 cancellation effective timestamp; resolves the as-was ruleset binding (governed contract)."
                          },
                          "coverage_start": {
                            "type": "string",
                            "format": "date-time",
                            "description": "RFC3339 start of the coverage period the refund applies to."
                          },
                          "coverage_end": {
                            "type": "string",
                            "format": "date-time",
                            "description": "RFC3339 end of the coverage period the refund applies to."
                          },
                          "refund_beneficiary_party_id": {
                            "type": "string",
                            "description": "Party that the refund is owed to. Recorded on the credit leg.",
                            "format": "typed-prefix-id",
                            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
                            "example": "pty_01arz3ndektsv4rrffq69g5fav",
                            "x-axiom-identifier-classification": "party-id",
                            "x-axiom-identifier-shape": "typed-prefix"
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "pro_rata": {
                  "summary": "Pro-rata refund example",
                  "value": {
                    "data": {
                      "type": "premium-cancellation-refunds",
                      "attributes": {
                        "policy_id": "pol_6wcq9sjx7b8q8vwbhdzbwdzzbd",
                        "product_id": "prod-001",
                        "cancellation_event_id": "evt-001",
                        "cancellation_date": "2026-04-01T00:00:00Z",
                        "coverage_start": "2026-01-01T00:00:00Z",
                        "coverage_end": "2027-01-01T00:00:00Z",
                        "refund_beneficiary_party_id": "party-001"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Idempotent replay; original transaction returned with `is_replay=true` and no new rows.",
            "headers": {
              "Content-Type": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "application/vnd.api+json"
                  ]
                }
              }
            },
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "premium-cancellation-refunds"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "prm_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "premium-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "attributes": {
                          "type": "object",
                          "required": [
                            "transaction_id",
                            "is_replay",
                            "ledger_entry_ids",
                            "explanation_tree_id"
                          ],
                          "properties": {
                            "transaction_id": {
                              "type": "string",
                              "x-axiom-identifier-classification": "ledger-transaction-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "is_replay": {
                              "type": "boolean",
                              "enum": [
                                true
                              ]
                            },
                            "ledger_entry_ids": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "explanation_tree_id": {
                              "type": "string",
                              "x-axiom-identifier-classification": "explanation-tree-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "refund_amount": {
                              "type": "integer",
                              "format": "int64",
                              "x-axiom-money-classification": "integer-minor-units-alpha-exception",
                              "x-axiom-money-currency-association": "sibling-currency-field",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "currency": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "201": {
            "description": "Refund evaluated. Non-zero refunds create a balanced premium_refund transaction; zero-refund outcomes persist explanation only.",
            "headers": {
              "Content-Type": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "application/vnd.api+json"
                  ]
                }
              }
            },
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "required": [
                        "type",
                        "id",
                        "attributes"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "premium-cancellation-refunds"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "description": "Ledger transaction_id of the posted refund; empty for zero-refund explanation-only outcomes.",
                          "format": "typed-prefix-id",
                          "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "prm_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "premium-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "attributes": {
                          "type": "object",
                          "required": [
                            "transaction_id",
                            "is_replay",
                            "ledger_entry_ids",
                            "explanation_tree_id"
                          ],
                          "properties": {
                            "transaction_id": {
                              "type": "string",
                              "x-axiom-identifier-classification": "ledger-transaction-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "is_replay": {
                              "type": "boolean",
                              "enum": [
                                false
                              ]
                            },
                            "ledger_entry_ids": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "minItems": 0,
                              "maxItems": 2,
                              "description": "Ordered debit-first, then credit for non-zero refunds; empty for zero-refund explanation-only outcomes."
                            },
                            "explanation_tree_id": {
                              "type": "string",
                              "description": "ID of the persisted AC-7 explanation tree (governed contract); same value stamped on both ledger legs.",
                              "x-axiom-identifier-classification": "explanation-tree-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "refund_amount": {
                              "type": "integer",
                              "format": "int64",
                              "description": "Refund amount in minor units (governed contract).",
                              "x-axiom-money-classification": "integer-minor-units-alpha-exception",
                              "x-axiom-money-currency-association": "sibling-currency-field",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "currency": {
                              "type": "string",
                              "minLength": 3,
                              "maxLength": 3
                            },
                            "method": {
                              "type": "string",
                              "enum": [
                                "pro_rata",
                                "short_rate",
                                "minimum_earned"
                              ]
                            },
                            "calculation": {
                              "$ref": "#/components/schemas/CalculationAttributes"
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Malformed request (bad RFC3339 dates, malformed JSON body).",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid actor context (governed contract `UNAUTHORIZED`)."
          },
          "415": {
            "description": "Unsupported media type \u2014 request must be `application/vnd.api+json`.\nEnvelope `errors[].code = UNSUPPORTED_MEDIA_TYPE`.\n"
          },
          "422": {
            "description": "Validation failure. Stable error codes (envelope `errors[].code`).\nConfig-shape codes follow the contract canonical error table; no generic\n`REFUND_CONFIG_INVALID` / `REFUND_CONFIG_NOT_FOUND_AS_OF` is returned\non the refund-config path.\n- `IDEMPOTENCY_KEY_REQUIRED` \u2014 missing or empty `Idempotency-Key` header.\n- `REFUND_BENEFICIARY_REQUIRED` \u2014 `refund_beneficiary_party_id` missing.\n- `CANCELLATION_EVENT_REQUIRED` \u2014 `cancellation_event_id` missing.\n- `BINDING_NOT_FOUND_AS_OF` \u2014 no as-was ruleset binding at `cancellation_date`,\n  or no `ruleset_version` for the binding (the provider collapses both\n  cases to this canonical code).\n- `REFUND_METHOD_REQUIRED` \u2014 `cancellation_refund.method` missing in the ruleset snapshot.\n- `REFUND_METHOD_UNSUPPORTED` \u2014 method is not one of\n  `pro_rata` / `short_rate` / `minimum_earned`.\n- `ROUNDING_MODE_REQUIRED` \u2014 `cancellation_refund.rounding_mode` missing.\n- `ROUNDING_MODE_UNSUPPORTED` \u2014 rounding mode is not `floor_minor_unit`.\n- `DAY_COUNT_CONVENTION_REQUIRED` \u2014 pro-rata method has no `day_count_convention`.\n- `DAY_COUNT_CONVENTION_UNSUPPORTED` \u2014 convention is not\n  `actual/365` / `actual/360` / `30/360` / `actual/actual`.\n- `SHORT_RATE_TABLE_REQUIRED` \u2014 short-rate method has no\n  `cancellation_refund.short_rate_table` or no `short_rate_table.version`.\n- `SHORT_RATE_TABLE_INVALID` \u2014 a `short_rate_table.rows[]` entry has\n  fractional / non-integer / out-of-range (`earned_pct_bps` \u2209 `[0, 10000]`)\n  values. Integer fields are decoded via `json.Number` and reject\n  `float64` outright (governed contract).\n- `SHORT_RATE_ROW_NOT_FOUND` \u2014 no row matches the elapsed months at\n  cancellation (raised by the calculator, not the provider).\n- `MINIMUM_EARNED_AMOUNT_REQUIRED` \u2014 minimum-earned method has no\n  `cancellation_refund.minimum_earned_amount_minor`.\n- `MINIMUM_EARNED_AMOUNT_INVALID` \u2014 minimum-earned amount is negative,\n  fractional, or not an int64.\n- `POLICY_DATES_INVALID` \u2014 coverage / cancellation dates incoherent.\n- `CURRENCY_REQUIRED`, `PAID_AMOUNT_REQUIRED` \u2014 calculator inputs missing.\n- `LEDGER_CATEGORY_INVALID` \u2014 entry produced with wrong `entry_category` (governed contract).\n- `LEDGER_POSTING_UNBALANCED` \u2014 debit total \u2260 credit total (defensive).\n- `REFUND_CONFIG_BINDING_REQUIRED` \u2014 defensive: provider called with nil binding.\n- `TENANT_CONTEXT_INVALID` \u2014 `X-Tenant-Context` is missing, malformed, or not authorized for tree storage.\n",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Service unavailable \u2014 cancellation refund service is not configured."
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "mixed",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/premiums/{id}/allocation": {
      "get": {
        "operationId": "getPremiumAllocation",
        "summary": "Get allocation snapshot for a premium",
        "description": "Returns the benefit-level allocation breakdown for a premium at a point in time.\nUses half-open temporal semantics under the governed contract.\n\nEach allocation row includes benefit_id, amount (Money object with amount_minor + currency_code), allocation_percentage_bps,\nallocation_basis, calculation_version, and allocation_rule_id (when basis is rule_based).\n",
        "tags": [
          "Premium"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "prm_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "premium-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Premium identifier"
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Point-in-time for temporal query (RFC3339). Defaults to now."
          }
        ],
        "responses": {
          "200": {
            "description": "Allocation snapshot retrieved successfully",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "type",
                          "id",
                          "attributes"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "enum": [
                              "premium-allocation-snapshots"
                            ]
                          },
                          "id": {
                            "type": "string",
                            "format": "typed-prefix-id",
                            "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
                            "example": "prm_01arz3ndektsv4rrffq69g5fav",
                            "x-axiom-identifier-classification": "premium-id",
                            "x-axiom-identifier-shape": "typed-prefix"
                          },
                          "attributes": {
                            "type": "object",
                            "required": [
                              "premium_id",
                              "benefit_id",
                              "amount",
                              "allocation_percentage_bps",
                              "allocation_basis",
                              "calculation_version",
                              "effective_from"
                            ],
                            "properties": {
                              "premium_id": {
                                "type": "string",
                                "format": "typed-prefix-id",
                                "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
                                "example": "prm_01arz3ndektsv4rrffq69g5fav",
                                "x-axiom-identifier-classification": "premium-id",
                                "x-axiom-identifier-shape": "typed-prefix"
                              },
                              "benefit_id": {
                                "type": "string",
                                "x-axiom-identifier-classification": "cover-id",
                                "x-axiom-identifier-shape": "opaque-string"
                              },
                              "amount": {
                                "allOf": [
                                  {
                                    "$ref": "#/components/schemas/Money"
                                  }
                                ],
                                "description": "Allocated amount (exact integer minor units + lowercase ISO-4217 currency code)."
                              },
                              "allocation_percentage_bps": {
                                "type": "integer",
                                "format": "int32",
                                "minimum": 0,
                                "maximum": 10000
                              },
                              "allocation_basis": {
                                "type": "string",
                                "enum": [
                                  "bottom_up",
                                  "fixed",
                                  "rule_based"
                                ]
                              },
                              "calculation_version": {
                                "type": "string"
                              },
                              "allocation_rule_id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "typed-prefix-id",
                                "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
                                "description": "Typed-prefix identifier for the allocation rule when allocation_basis is rule_based."
                              },
                              "effective_from": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "effective_to": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "format": "date-time"
                              },
                              "trigger": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (malformed as_of timestamp)",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "No allocation snapshot found for this premium",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "errors"
                  ],
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                          },
                          "code": {
                            "type": "string",
                            "x-axiom-coded-value-classification": "tenant-catalogue-code"
                          },
                          "title": {
                            "type": "string"
                          },
                          "detail": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/quotes": {
      "post": {
        "tags": [
          "Policy"
        ],
        "summary": "Create a new quote",
        "description": "Creates a persisted premium calculation (quote) with a 30-minute TTL.\nExactly one of pricing_snapshot_id, products, or product_id must be provided.\n",
        "operationId": "createQuote",
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateQuoteRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Quote created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteResponse"
                },
                "example": {
                  "status": "success",
                  "data": {
                    "quote_id": "qte-a1b2c3d4",
                    "product_id": "prod-abc123",
                    "effective_date": "2026-04-01T00:00:00Z",
                    "expiry_date": "2027-04-01T00:00:00Z",
                    "underwriting_data": {
                      "age": 35,
                      "vehicle_value": 25000
                    },
                    "covers_selected": [
                      "COMP",
                      "TPL"
                    ],
                    "pricing_snapshot": {},
                    "created_at": "2026-06-10T10:00:00Z",
                    "valid_until": "2026-06-10T10:30:00Z",
                    "actor_type": "human",
                    "actor_id": "usr-abc",
                    "actor_original_id": "usr-abc"
                  },
                  "telemetry": {
                    "total_ms": 42,
                    "trace_id": "trace-abc123"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "description": "Actor attribution missing or invalid. Code: ACTOR_ATTRIBUTION_REQUIRED.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Semantic validation failure. Codes: PRICING_INPUT_REQUIRED,\nPRICING_INPUT_CONFLICT, EFFECTIVE_DATE_INVALID, EXPIRY_DATE_INVALID,\nSUPERSEDES_QUOTE_NOT_FOUND, TENANT_REQUIRED.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "PRICING_INPUT_REQUIRED",
                      "title": "Validation Error",
                      "detail": "Exactly one of pricing_snapshot_id, products, or product_id must be provided"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "tags": [
          "Policy"
        ],
        "summary": "List quotes by comparison reference",
        "description": "Returns all quotes for a given comparison_ref, ordered by created_at DESC.\nTenant-scoped to prevent cross-tenant leakage.\n",
        "operationId": "listQuotesByComparisonRef",
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "comparison_ref",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Comparison reference to filter quotes"
          }
        ],
        "responses": {
          "200": {
            "description": "Quotes matching the comparison reference",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteListResponse"
                },
                "example": {
                  "status": "success",
                  "data": [
                    {
                      "quote_id": "qte-a1b2c3d4",
                      "product_id": "prod-abc123",
                      "effective_date": "2026-04-01T00:00:00Z",
                      "expiry_date": "2027-04-01T00:00:00Z",
                      "underwriting_data": {},
                      "covers_selected": [],
                      "pricing_snapshot": {},
                      "created_at": "2026-06-10T10:00:00Z",
                      "valid_until": "2026-06-10T10:30:00Z",
                      "actor_type": "human",
                      "actor_id": "usr-abc",
                      "actor_original_id": "usr-abc",
                      "comparison_ref": "cmp-xyz789"
                    }
                  ],
                  "telemetry": {
                    "total_ms": 18,
                    "trace_id": "trace-def456"
                  }
                }
              }
            }
          },
          "422": {
            "description": "Missing comparison_ref (COMPARISON_REF_REQUIRED)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "comparison_ref"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/quotes/{id}": {
      "get": {
        "tags": [
          "Policy"
        ],
        "summary": "Retrieve a quote by ID",
        "description": "Returns the persisted quote if active. Returns 404 for unknown IDs\n(including cross-tenant lookups) and 410 Gone for expired quotes.\n",
        "operationId": "getQuote",
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "qte_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "quote-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Quote identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Active quote retrieved",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteResponse"
                },
                "example": {
                  "status": "success",
                  "data": {
                    "quote_id": "qte-a1b2c3d4",
                    "product_id": "prod-abc123",
                    "effective_date": "2026-04-01T00:00:00Z",
                    "expiry_date": "2027-04-01T00:00:00Z",
                    "underwriting_data": {},
                    "covers_selected": [],
                    "pricing_snapshot": {},
                    "created_at": "2026-06-10T10:00:00Z",
                    "valid_until": "2026-06-10T10:30:00Z",
                    "actor_type": "human",
                    "actor_id": "usr-abc",
                    "actor_original_id": "usr-abc"
                  },
                  "telemetry": {
                    "total_ms": 12,
                    "trace_id": "trace-ghi789"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Quote not found (QUOTE_NOT_FOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "404",
                      "code": "QUOTE_NOT_FOUND",
                      "title": "Not Found",
                      "detail": "Quote not found or belongs to a different tenant"
                    }
                  ]
                }
              }
            }
          },
          "410": {
            "description": "Quote has expired (QUOTE_EXPIRED)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "410",
                      "code": "QUOTE_EXPIRED",
                      "title": "Gone",
                      "detail": "Quote has expired (valid_until exceeded)"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/quotes/{id}/approve": {
      "post": {
        "tags": [
          "Policy"
        ],
        "summary": "Approve a quote (indicative to firm)",
        "description": "Transitions a quote from indicative to firm status.\nRequires actor attribution (governed contract).\n",
        "operationId": "approveQuote",
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "qte_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "quote-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Quote identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Quote approved (status changed to firm)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteResponse"
                },
                "example": {
                  "status": "success",
                  "data": {
                    "quote_id": "qte-a1b2c3d4",
                    "product_id": "prod-abc123",
                    "effective_date": "2026-04-01T00:00:00Z",
                    "expiry_date": "2027-04-01T00:00:00Z",
                    "underwriting_data": {},
                    "covers_selected": [],
                    "pricing_snapshot": {},
                    "created_at": "2026-06-10T10:00:00Z",
                    "valid_until": "2026-06-10T10:30:00Z",
                    "actor_type": "human",
                    "actor_id": "usr-abc",
                    "actor_original_id": "usr-abc"
                  },
                  "telemetry": {
                    "total_ms": 15,
                    "trace_id": "trace-jkl012"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Actor attribution missing or invalid (ACTOR_ATTRIBUTION_REQUIRED).\n was 422 prior to this change.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Quote not found (QUOTE_NOT_FOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "410": {
            "description": "Quote has expired (QUOTE_EXPIRED)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Invalid transition (INVALID_QUOTE_TRANSITION) or\nmissing tenant (TENANT_REQUIRED).\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/quotes/{id}/decline": {
      "post": {
        "tags": [
          "Policy"
        ],
        "summary": "Decline a quote",
        "description": "Transitions a quote to declined status. Requires a reason_code.\nRequires actor attribution (governed contract).\n",
        "operationId": "declineQuote",
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "qte_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "quote-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Quote identifier"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeclineQuoteRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Quote declined",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteResponse"
                },
                "example": {
                  "status": "success",
                  "data": {
                    "quote_id": "qte-a1b2c3d4",
                    "product_id": "prod-abc123",
                    "effective_date": "2026-04-01T00:00:00Z",
                    "expiry_date": "2027-04-01T00:00:00Z",
                    "underwriting_data": {},
                    "covers_selected": [],
                    "pricing_snapshot": {},
                    "created_at": "2026-06-10T10:00:00Z",
                    "valid_until": "2026-06-10T10:30:00Z",
                    "actor_type": "human",
                    "actor_id": "usr-abc",
                    "actor_original_id": "usr-abc"
                  },
                  "telemetry": {
                    "total_ms": 11,
                    "trace_id": "trace-mno345"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Actor attribution missing or invalid (ACTOR_ATTRIBUTION_REQUIRED).\n was 422 prior to this change.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Quote not found (QUOTE_NOT_FOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "410": {
            "description": "Quote has expired (QUOTE_EXPIRED)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Missing reason_code (DECLINE_REASON_REQUIRED),\ninvalid transition (INVALID_QUOTE_TRANSITION), or\nmissing tenant (TENANT_REQUIRED).\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/quotes/{id}/bind": {
      "post": {
        "tags": [
          "Policy"
        ],
        "summary": "Bind a firm quote to create a policy",
        "description": "Binds a firm quote, creating a policy, premium allocation, ledger entries,\nand explanation tree. Only firm quotes can be bound.\nRequires actor attribution (governed contract).\n",
        "operationId": "bindQuote",
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "qte_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "quote-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Quote identifier"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Idempotency key for bind operations (required under the governed contract)"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BindQuoteRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Quote bound successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BindQuoteResultResponse"
                },
                "example": {
                  "status": "success",
                  "data": {
                    "quote_id": "qte-a1b2c3d4",
                    "policy_id": "pol-xyz789",
                    "premium_ids": [
                      "prm-abc001"
                    ],
                    "allocation_explanation_tree_id": "tree-001",
                    "ledger_entry_ids": [
                      "led-001",
                      "led-002"
                    ]
                  },
                  "telemetry": {
                    "total_ms": 340,
                    "trace_id": "trace-pqr678"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing required input. Codes: IDEMPOTENCY_KEY_REQUIRED, INVALID_REQUEST.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "400",
                      "code": "IDEMPOTENCY_KEY_REQUIRED",
                      "title": "Bad Request",
                      "detail": "Idempotency-Key header is required for bind operations"
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Quote not found (QUOTE_NOT_FOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "404",
                      "code": "QUOTE_NOT_FOUND",
                      "title": "Not Found",
                      "detail": "Quote not found or belongs to a different tenant"
                    }
                  ]
                }
              }
            }
          },
          "409": {
            "description": "Quote already bound (QUOTE_ALREADY_BOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "409",
                      "code": "QUOTE_ALREADY_BOUND",
                      "title": "Conflict",
                      "detail": "Quote has already been bound to a policy"
                    }
                  ]
                }
              }
            }
          },
          "410": {
            "description": "Quote has expired (QUOTE_EXPIRED)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "410",
                      "code": "QUOTE_EXPIRED",
                      "title": "Gone",
                      "detail": "Quote has expired (valid_until exceeded)"
                    }
                  ]
                }
              }
            }
          },
          "412": {
            "description": "Quote not in firm status (QUOTE_NOT_FIRM)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "412",
                      "code": "QUOTE_NOT_FIRM",
                      "title": "Precondition Failed",
                      "detail": "Quote must be in firm status to bind"
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "Validation failure. Codes: QUOTE_SNAPSHOT_INVALID,\nPREMIUM_DRIFT_EXCEEDED, LEDGER_IMBALANCED,\nQUOTE_PARTY_MISMATCH_REQUOTE_REQUIRED,\nSUPERSEDES_QUOTE_NOT_FOUND, TENANT_REQUIRED.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "QUOTE_SNAPSHOT_INVALID",
                      "title": "Validation Error",
                      "detail": "Quote pricing snapshot is no longer valid"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/quotes/{id}/chain": {
      "get": {
        "tags": [
          "Policy"
        ],
        "summary": "Get quote supersession chain",
        "description": "Returns the full supersession chain for a quote, ordered oldest-first.\nWalks backward through supersedes_quote_id links and reverses.\n",
        "operationId": "getQuoteChain",
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "qte_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "quote-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Quote identifier"
          }
        ],
        "responses": {
          "200": {
            "description": "Supersession chain (oldest-first)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QuoteListResponse"
                },
                "example": {
                  "status": "success",
                  "data": [
                    {
                      "quote_id": "qte-earlier",
                      "product_id": "prod-abc123",
                      "effective_date": "2026-04-01T00:00:00Z",
                      "expiry_date": "2027-04-01T00:00:00Z",
                      "underwriting_data": {},
                      "covers_selected": [],
                      "pricing_snapshot": {},
                      "created_at": "2026-06-09T10:00:00Z",
                      "valid_until": "2026-06-09T10:30:00Z",
                      "actor_type": "human",
                      "actor_id": "usr-abc",
                      "actor_original_id": "usr-abc"
                    },
                    {
                      "quote_id": "qte-a1b2c3d4",
                      "product_id": "prod-abc123",
                      "effective_date": "2026-04-01T00:00:00Z",
                      "expiry_date": "2027-04-01T00:00:00Z",
                      "underwriting_data": {},
                      "covers_selected": [],
                      "pricing_snapshot": {},
                      "created_at": "2026-06-10T10:00:00Z",
                      "valid_until": "2026-06-10T10:30:00Z",
                      "actor_type": "human",
                      "actor_id": "usr-abc",
                      "actor_original_id": "usr-abc",
                      "supersedes_quote_id": "qte-earlier"
                    }
                  ],
                  "telemetry": {
                    "total_ms": 9,
                    "trace_id": "trace-stu901"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Quote not found (QUOTE_NOT_FOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/payments": {
      "get": {
        "operationId": "listPayments",
        "summary": "List payments",
        "description": "Retrieves a cursor-paginated list of payments for the current tenant.\n\nResults are sorted by created_at descending with id as a stable\ntie-breaker.\n\nUse `page[size]` and `page[after]` for pagination. Legacy `limit` and\n`offset` query parameters are rejected.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return (default 20, max 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "example": 20
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as `meta.next_cursor` by the previous page.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of payments retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentListResponse"
                },
                "example": {
                  "data": [
                    {
                      "id": "pay_20260403_0001",
                      "amount": {
                        "amount_minor": 125000,
                        "currency_code": "usd"
                      },
                      "status": "completed",
                      "payment_method": "debit_order",
                      "description": "Monthly premium \u2014 motor comprehensive policy POL-2026-00123",
                      "reference_id": "ref_20260408_0001",
                      "reference_type": "premium",
                      "created_at": "2026-04-01T06:00:00Z",
                      "updated_at": "2026-04-01T08:30:00Z",
                      "processed_at": "2026-04-01T08:30:00Z"
                    },
                    {
                      "id": "pay_20260403_0001",
                      "amount": {
                        "amount_minor": 340000,
                        "currency_code": "gbp"
                      },
                      "status": "pending",
                      "payment_method": "bank_transfer",
                      "description": "Quarterly premium \u2014 property all-risks POL-2026-00456",
                      "reference_id": "ref_20260408_0001",
                      "reference_type": "premium",
                      "created_at": "2026-04-02T09:15:00Z",
                      "updated_at": "2026-04-02T09:15:00Z",
                      "processed_at": null
                    }
                  ],
                  "meta": {
                    "page_size": 20,
                    "has_more": true,
                    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNC0wMlQwOToxNTowMFoiLCJpZCI6ImM5ZDBlMWYyLWEzYjQtNTY3OC1jZGVmLTc4OTAxMjM0NTY3OCJ9"
                  },
                  "status": "success",
                  "message": "Payments retrieved successfully"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "createPayment",
        "summary": "Create a payment",
        "description": "Creates a new payment record in `pending` status.\n\nThe payment is not processed immediately. Use the\n`POST /v1/payments/{id}/process` endpoint to initiate processing.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePaymentRequest"
              },
              "example": {
                "amount": {
                  "amount_minor": 275000,
                  "currency_code": "kes"
                },
                "payment_method": "bank_transfer",
                "description": "Annual premium \u2014 liability professional indemnity POL-2026-00789",
                "reference_id": "ref_20260408_0001",
                "reference_type": "premium",
                "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                "metadata": {
                  "source": "broker-portal",
                  "broker_id": "BRK-0087"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Payment created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentResponse"
                },
                "example": {
                  "data": {
                    "id": "pay_20260403_0001",
                    "amount": {
                      "amount_minor": 275000,
                      "currency_code": "kes"
                    },
                    "status": "pending",
                    "payment_method": "bank_transfer",
                    "description": "Annual premium \u2014 liability professional indemnity POL-2026-00789",
                    "reference_id": "ref_20260408_0001",
                    "reference_type": "premium",
                    "party_id": "pty_01abcdefghjkmnpqrstvwxyz01",
                    "metadata": {
                      "source": "broker-portal",
                      "broker_id": "BRK-0087"
                    },
                    "created_at": "2026-04-03T10:00:00Z",
                    "updated_at": "2026-04-03T10:00:00Z",
                    "processed_at": null
                  },
                  "status": "success",
                  "message": "Payment created successfully"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/payments/{id}": {
      "get": {
        "operationId": "getPayment",
        "summary": "Get a payment by ID",
        "description": "Retrieves a single payment by its unique identifier.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed payment identifier",
            "schema": {
              "type": "string",
              "example": "pay_20260403_0001",
              "x-axiom-identifier-classification": "payment-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Payment retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "put": {
        "operationId": "updatePayment",
        "summary": "Update a payment",
        "description": "Updates a payment record. Only payments in `pending` status can be updated.\n\nFields that can be updated: amount, currency, payment_method, description,\nreference_id, reference_type, metadata.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed payment identifier",
            "schema": {
              "type": "string",
              "example": "pay_20260403_0001",
              "x-axiom-identifier-classification": "payment-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/Money"
                      }
                    ],
                    "description": "Updated payment amount (exact integer minor units + lowercase ISO-4217 currency code)."
                  },
                  "payment_method": {
                    "$ref": "#/components/schemas/PaymentMethod"
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Updated human-readable description",
                    "example": "Adjusted monthly premium \u2014 motor comprehensive policy POL-2026-00123"
                  },
                  "reference_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Updated reference to associated resource"
                  },
                  "reference_type": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Updated type of referenced resource"
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": true,
                    "description": "Updated extensible metadata"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Payment updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/payments/{id}/process": {
      "post": {
        "operationId": "processPayment",
        "summary": "Process a payment",
        "description": "Initiates processing for a pending payment.\n\nTransitions the payment through the lifecycle:\n`pending` -> `processing` -> `completed` (or `failed`).\n\nThis is an asynchronous operation. The response confirms the payment\nhas been submitted for processing. Poll the payment status or use\nwebhooks to track completion.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed payment identifier",
            "schema": {
              "type": "string",
              "example": "pay_20260403_0001",
              "x-axiom-identifier-classification": "payment-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Payment submitted for processing",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentResponse"
                },
                "example": {
                  "data": {
                    "id": "pay_20260403_0001",
                    "amount": {
                      "amount_minor": 125000,
                      "currency_code": "usd"
                    },
                    "status": "pending",
                    "payment_method": "debit_order",
                    "description": "Monthly premium \u2014 motor comprehensive policy POL-2026-00123",
                    "created_at": "2026-04-01T06:00:00Z",
                    "updated_at": "2026-04-01T08:30:00Z",
                    "processed_at": null
                  },
                  "status": "success",
                  "message": "Payment submitted for processing"
                }
              }
            }
          },
          "400": {
            "description": "Bad request or payment is not in a processable state (INVALID_REQUEST)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "400",
                      "code": "INVALID_REQUEST",
                      "title": "Bad Request",
                      "detail": "Payment is in 'completed' status and cannot be processed again"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/payments/{id}/cancel": {
      "post": {
        "operationId": "cancelPayment",
        "summary": "Cancel a payment",
        "description": "Cancels a payment. Only payments in `pending` or `processing` status\ncan be cancelled.\n\nTransitions the payment to `cancelled` status. This action cannot be undone.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed payment identifier",
            "schema": {
              "type": "string",
              "example": "pay_20260403_0001",
              "x-axiom-identifier-classification": "payment-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Payment cancelled successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentResponse"
                },
                "example": {
                  "data": {
                    "id": "pay_20260403_0001",
                    "amount": {
                      "amount_minor": 125000,
                      "currency_code": "usd"
                    },
                    "status": "cancelled",
                    "payment_method": "debit_order",
                    "description": "Monthly premium \u2014 motor comprehensive policy POL-2026-00123",
                    "created_at": "2026-04-01T06:00:00Z",
                    "updated_at": "2026-04-03T11:00:00Z",
                    "processed_at": null
                  },
                  "status": "success",
                  "message": "Payment cancelled successfully"
                }
              }
            }
          },
          "400": {
            "description": "Bad request or payment is not in a cancellable state (INVALID_REQUEST)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "400",
                      "code": "INVALID_REQUEST",
                      "title": "Bad Request",
                      "detail": "Payment is in 'completed' status and cannot be cancelled"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/invoices": {
      "get": {
        "operationId": "listInvoices",
        "summary": "List invoices with cursor pagination",
        "description": "Retrieves a paginated list of invoices for the current tenant using\ncursor-based pagination under the governed contract.\n\nLegacy offset-based pagination (limit/offset query params) is rejected\nwith 400 LEGACY_PAGINATION.\n\nResults sorted by created_at descending.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return (default 25, max 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Cursor for the next page (invoice ID from previous response)",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Invoices retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceListResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request. Codes: MISSING_TENANT, LEGACY_PAGINATION,\nINVALID_PAGE_SIZE, PAGE_SIZE_EXCEEDED.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "missing_tenant": {
                    "summary": "Missing tenant header",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "MISSING_TENANT",
                          "title": "Missing Tenant",
                          "detail": "X-Tenant-Context header is required"
                        }
                      ]
                    }
                  },
                  "legacy_pagination": {
                    "summary": "Legacy pagination rejected",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "LEGACY_PAGINATION",
                          "title": "Legacy Pagination Not Supported",
                          "detail": "Use page[size] and page[after] for cursor-based pagination under the governed contract"
                        }
                      ]
                    }
                  },
                  "invalid_page_size": {
                    "summary": "Invalid page size",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "INVALID_PAGE_SIZE",
                          "title": "Invalid Page Size",
                          "detail": "page[size] must be a positive integer"
                        }
                      ]
                    }
                  },
                  "page_size_exceeded": {
                    "summary": "Page size exceeds maximum",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "PAGE_SIZE_EXCEEDED",
                          "title": "Page Size Exceeded",
                          "detail": "page[size] must not exceed 100"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/invoices/{id}": {
      "get": {
        "operationId": "getInvoice",
        "summary": "Get a single invoice by ID",
        "description": "Retrieves a single invoice by its unique identifier.\nReturns 404 for unknown IDs or cross-tenant access attempts.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Invoice identifier",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "invoice-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Invoice retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceResponse"
                }
              }
            }
          },
          "400": {
            "description": "Missing tenant header (MISSING_TENANT)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "400",
                      "code": "MISSING_TENANT",
                      "title": "Missing Tenant",
                      "detail": "X-Tenant-Context header is required"
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Invoice not found (INVOICE_NOT_FOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "404",
                      "code": "INVOICE_NOT_FOUND",
                      "title": "Invoice Not Found",
                      "detail": "The requested invoice does not exist or belongs to another tenant"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/invoices/{id}/finalize": {
      "post": {
        "operationId": "finalizeInvoice",
        "summary": "Finalize an invoice",
        "description": "Finalizes a draft invoice, making it immutable.\nRequires actor attribution headers under the governed contract.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "X-Actor-ID",
            "in": "header",
            "required": true,
            "description": "Actor identifier (governed contract)",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "actor-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "X-Actor-Type",
            "in": "header",
            "required": true,
            "description": "Actor type (governed contract)",
            "schema": {
              "type": "string",
              "enum": [
                "human",
                "service",
                "agent"
              ]
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Invoice identifier",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "invoice-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Invoice finalized successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceResponse"
                }
              }
            }
          },
          "400": {
            "description": "Missing required header. Codes: MISSING_TENANT,\nMISSING_ACTOR_ID, MISSING_ACTOR_TYPE.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "missing_tenant": {
                    "summary": "Missing tenant header",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "MISSING_TENANT",
                          "title": "Missing Tenant",
                          "detail": "X-Tenant-Context header is required"
                        }
                      ]
                    }
                  },
                  "missing_actor_id": {
                    "summary": "Missing actor ID header",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "MISSING_ACTOR_ID",
                          "title": "Missing Actor ID",
                          "detail": "X-Actor-ID header is required for mutation endpoints"
                        }
                      ]
                    }
                  },
                  "missing_actor_type": {
                    "summary": "Missing actor type header",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "MISSING_ACTOR_TYPE",
                          "title": "Missing Actor Type",
                          "detail": "X-Actor-Type header is required for mutation endpoints"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Invoice not found (INVOICE_NOT_FOUND)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "404",
                      "code": "INVOICE_NOT_FOUND",
                      "title": "Invoice Not Found",
                      "detail": "The requested invoice does not exist or belongs to another tenant"
                    }
                  ]
                }
              }
            }
          },
          "409": {
            "description": "Invoice already finalized (INVOICE_CONFLICT)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "409",
                      "code": "INVOICE_CONFLICT",
                      "title": "Invoice Conflict",
                      "detail": "Invoice has already been finalized and cannot be modified"
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "Invalid invoice state (INVALID_INVOICE_STATE)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "INVALID_INVOICE_STATE",
                      "title": "Invalid Invoice State",
                      "detail": "Invoice is not in a state that allows finalization"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/billing/cycles/close": {
      "post": {
        "operationId": "closeBillingCycle",
        "summary": "Close a billing cycle",
        "description": "Closes a billing cycle for the specified period, generating an invoice.\nRequires actor attribution headers under the governed contract.\n",
        "tags": [
          "Payment"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "X-Actor-ID",
            "in": "header",
            "required": true,
            "description": "Actor identifier (governed contract)",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "actor-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "X-Actor-Type",
            "in": "header",
            "required": true,
            "description": "Actor type (governed contract)",
            "schema": {
              "type": "string",
              "enum": [
                "human",
                "service",
                "agent"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "period_start",
                  "period_end"
                ],
                "properties": {
                  "period_start": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Start of the billing period (RFC3339)",
                    "example": "2026-03-01T00:00:00Z"
                  },
                  "period_end": {
                    "type": "string",
                    "format": "date-time",
                    "description": "End of the billing period (RFC3339)",
                    "example": "2026-03-31T23:59:59Z"
                  },
                  "idempotency_key": {
                    "type": "string",
                    "description": "Optional idempotency key for deduplication"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Billing cycle closed and invoice created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceResponse"
                }
              }
            }
          },
          "400": {
            "description": "Missing required header or invalid request body.\nCodes: MISSING_TENANT, MISSING_ACTOR_ID, MISSING_ACTOR_TYPE, INVALID_REQUEST.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "missing_tenant": {
                    "summary": "Missing tenant header",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "MISSING_TENANT",
                          "title": "Missing Tenant",
                          "detail": "X-Tenant-Context header is required"
                        }
                      ]
                    }
                  },
                  "invalid_request": {
                    "summary": "Invalid request body",
                    "value": {
                      "errors": [
                        {
                          "status": "400",
                          "code": "INVALID_REQUEST",
                          "title": "Invalid Request",
                          "detail": "Request body must include period_start and period_end in RFC3339 format"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Invoice immutable conflict (INVOICE_IMMUTABLE)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "409",
                      "code": "INVOICE_IMMUTABLE",
                      "title": "Billing Error",
                      "detail": "Invoice for this period has already been finalized"
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "Invalid cycle window (INVALID_CYCLE_WINDOW)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "INVALID_CYCLE_WINDOW",
                      "title": "Invalid Cycle Window",
                      "detail": "period_end must be after period_start"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ledger/accounts/{code}/balance": {
      "get": {
        "operationId": "getAccountBalance",
        "summary": "Get account balance",
        "description": "Computes and returns the balance for a specific ledger account.\n\nSupports point-in-time queries via the `as_of` parameter for\nhistorical balance lookups (as-was semantics per platform principle).\n\nThe response includes an explanation tree documenting the inputs,\nrule version, and computation method used.\n",
        "tags": [
          "Ledger"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "code",
            "in": "path",
            "required": true,
            "description": "Account code to query (e.g. PREM-RCV-001, CLM-PAY-001)",
            "schema": {
              "type": "string",
              "example": "PREM-RCV-001"
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "description": "Point-in-time for the balance computation (ISO 8601).\nIf omitted, returns the current balance.\n",
            "schema": {
              "type": "string",
              "format": "date-time",
              "example": "2026-03-31T23:59:59Z"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Account balance computed successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BalanceResultResponse"
                },
                "example": {
                  "data": {
                    "account_code": "PREM-RCV-001",
                    "as_of": "2026-03-31T23:59:59Z",
                    "currency": "usd",
                    "amount": 4525075,
                    "entry_count": 128,
                    "explanation": {
                      "inputs": {
                        "account_code": "PREM-RCV-001",
                        "date_from": "2026-01-01T00:00:00Z",
                        "date_to": "2026-03-31T23:59:59Z",
                        "include_pending": false
                      },
                      "rule_version": "balance-calc-v2.1.0",
                      "computation": "Sum of posted credits minus posted debits for account PREM-RCV-001",
                      "entry_ids": [
                        "ref_20260408_0001",
                        "ref_20260408_0001"
                      ]
                    }
                  },
                  "status": "success",
                  "message": "Account balance computed successfully"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ledger/entries/{entry_id}/reversals": {
      "post": {
        "operationId": "createReversal",
        "summary": "Create a ledger entry reversal",
        "description": "Creates a reversing entry for a previously posted ledger entry.\nThe original entry's status transitions to `reversed`, and a new\nentry with the opposite entry_type and same amount is created.\n\nThis preserves the full audit trail rather than modifying or\ndeleting the original entry (platform principle explainability).\n",
        "tags": [
          "Ledger"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "entry_id",
            "in": "path",
            "required": true,
            "description": "Ledger entry UUID to reverse",
            "schema": {
              "type": "string",
              "example": "ref_20260408_0001",
              "x-axiom-identifier-classification": "ledger-entry-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reason",
                  "posted_by"
                ],
                "properties": {
                  "reason": {
                    "type": "string",
                    "description": "Reason for the reversal (required for audit trail)",
                    "example": "Incorrect account code \u2014 premium posted to retained claim-family compatibility payable in error"
                  },
                  "posted_by": {
                    "type": "string",
                    "description": "User or service authorising the reversal",
                    "example": "hello@axiom.express"
                  },
                  "entry_date": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Accounting date for the reversal (defaults to now)",
                    "example": "2026-04-01T00:00:00Z"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "reason": "Incorrect account code \u2014 premium posted to retained claim-family compatibility payable in error",
                "posted_by": "hello@axiom.express",
                "entry_date": "2026-04-01T00:00:00Z"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Reversal entry created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LedgerReversalResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "description": "Entry has already been reversed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "409",
                      "code": "STATE_CONFLICT",
                      "title": "Conflict",
                      "detail": "Ledger entry has already been reversed"
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ledger/integrity/verify": {
      "post": {
        "operationId": "verifyIntegrity",
        "summary": "Verify tamper-evidence for named ledger entries",
        "description": "Recomputes the canonical content hash of each entry you name and compares\nit to the hash stored with that entry, optionally following the entry's\nreversal lineage and checking every ancestor the same way (governed contract\ntamper-evidence). Read-only; modifies nothing.\n\n**Scope.** This verifies the entries in `entry_ids` and nothing else. It\ndoes not discover entries, does not scan a date range, and cannot report on\na population you did not enumerate. A clean result means \"the entries I\nnamed are unaltered\", never \"the ledger is sound\".\n\n**What this operation does NOT do.** Until 2026-09-17 this description\nclaimed it detected *unbalanced transactions, orphaned entries, or sequence\ngaps*. It has never done any of those things, and the response schema \u2014\nper-entry hashes and lineage depth \u2014 has always shown as much. That promise is\nremoved rather than kept as an aspiration.\n\nThose properties are enforced elsewhere, at write time rather than by\nlater inspection:\n\n- **Balance** is enforced by a DEFERRABLE CONSTRAINT TRIGGER that refuses\n  any commit leaving a `(transaction_id, currency_code)` group with a\n  non-zero net. An unbalanced transaction cannot be committed, so there is\n  no post-hoc detection to perform on entries written under that guard.\n- **Lineage** integrity for entries you name IS covered here, via\n  `MISSING_LINK` and `CHAIN_BREAK`.\n- **Sequence gaps** are not a property this ledger asserts; entry ids are\n  not a gapless sequence and a \"gap\" carries no meaning to detect.\n\n**If you need an attestation.** A statement of the form \"our ledger was\nverified for period X\" needs an instrument that states its population,\nscope, as-at instant and the control state at that time, and that refuses\nrather than returning a clean zero when it cannot observe its subject.\nThis operation is not that instrument and should not be described as one to\nan auditor. What it can honestly support is narrower and still useful: for\nthe entries named, the stored content has not been altered since it was\nwritten.\n",
        "tags": [
          "Ledger"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerifyIntegrityRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Verification completed. A 200 means every named entry was examined and\nreported on; it does NOT mean every entry passed. Inspect each\n`results[].status` \u2014 a `FAIL` is reported in the body, not as an HTTP\nerror.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LedgerIntegrityResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ledger/entries": {
      "get": {
        "operationId": "listLedgerEntries",
        "summary": "List ledger entries for the tenant",
        "description": "Returns the tenant's ledger entries (keyset-ordered by `entry_id`\nascending). Cursor-paginated under the governed contract: pass `page[size]`\nto bound the page and `page[after]` (an opaque cursor from a prior\nresponse's `meta.next_cursor`) to fetch the next page. Each entry is a\ndouble-entry posting line (governed contract); amounts are exact integer minor units.\n\nOptional `reference_id` filter narrows the list to the postings recorded\nagainst a single source reference (for example a retained claim-family\ncompatibility id, policy id, premium id, or payment id). Absent = all\nentries for the tenant. The filter composes with\nthe existing operating-tenant tenant-isolated scope; it never widens it.\n",
        "tags": [
          "Ledger"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "reference_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "ledger-reference-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Optional filter \u2014 return only entries posted against this source\nreference id (`reference_id`, for example a retained claim-family\ncompatibility id, policy id, premium id, or payment id). Absent = all\nentries for the tenant.\n"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            },
            "description": "Maximum number of entries to return (cursor page size, governed contract)."
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Opaque cursor from a prior response's `meta.next_cursor`. Treat as\nopaque; do not construct or modify. Omit to fetch the first page.\n"
          }
        ],
        "responses": {
          "200": {
            "description": "Ledger entries for the tenant",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LedgerEntryListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "reference_id"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ledger/entries/{entry_id}/corrections": {
      "get": {
        "operationId": "getCorrections",
        "summary": "Get corrections for a ledger entry",
        "description": "Retrieves the correction history for a specific ledger entry,\nincluding any reversals and re-postings.\n\nResults sorted by created_at descending.\n\nThis supports the full audit trail and explainability requirements. \u2014 every correction is traceable back to the original entry.\n",
        "tags": [
          "Ledger"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "entry_id",
            "in": "path",
            "required": true,
            "description": "Original ledger entry UUID",
            "schema": {
              "type": "string",
              "example": "ref_20260408_0001",
              "x-axiom-identifier-classification": "ledger-entry-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Corrections retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LedgerCorrectionsResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ledger/trial-balance": {
      "get": {
        "operationId": "getTrialBalance",
        "summary": "Get the trial balance for a window",
        "description": "Returns the trial balance for the operating tenant over a business-time\nwindow: for every account with posted activity, debits in one column and\ncredits in the other, split by currency.\n\nWHY `period_start` AND `period_end` ARE BOTH REQUIRED. A trial balance without a window is\nnot a trial balance; it is a sum over whatever happens to be in the table.\nThe endpoint does not choose a window on the caller's behalf, because that\nwould be inventing the scope of an accounting assertion.\n\nCURRENCIES ARE NEVER SUMMED ACROSS. Each currency gets its own trial\nbalance and its own `balanced` flag. A total mixing `zar` and `usd` is not\na number.\n\nUNPOSTED ENTRIES ARE EXCLUDED FROM EVERY FIGURE, and the count of what was\nexcluded is reported alongside the result rather than folded into it, so a\ncaller can tell a small book from a narrow window and a balanced book from\na balanced subset.\n\nAN UNBALANCED BOOK IS STILL 200. The request succeeded: a trial balance was\ncomputed over the window asked for. Whether the book balances is reported\nin `balanced` and `certified`, which states it more precisely than an error\nstatus could.\n",
        "tags": [
          "Ledger"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "period_start",
            "in": "query",
            "required": true,
            "description": "Inclusive start of the business-time window (RFC3339).",
            "schema": {
              "type": "string",
              "format": "date-time",
              "example": "2026-03-01T00:00:00Z"
            }
          },
          {
            "name": "period_end",
            "in": "query",
            "required": true,
            "description": "Inclusive end of the business-time window (RFC3339).",
            "schema": {
              "type": "string",
              "format": "date-time",
              "example": "2026-03-31T23:59:59Z"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Trial balance computed. A `200` asserts that the figures were produced\nover the requested window, not that the book balances \u2014 read `balanced`\nand `certified` for that.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialBalanceResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "period_start",
            "period_end"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets": {
      "post": {
        "operationId": "createRuleset",
        "x-axiom-substrate-kind": "ruleset",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Create a ruleset",
        "description": "Creates a new ruleset in `draft` status.\n\nRulesets are versioned containers of business rules that govern\ndomain rule lanes such as underwriting, pricing, retained claim-family assessment,\ndocument completeness, or discount composition. Rules are data. \u2014 explicit, versioned,\ndeterministic, and auditable.\n\nOptionally specify a `base_ruleset` UUID to copy rules from\nan existing ruleset as a starting point. Copied rules preserve their\nbusiness codes and receive new technical IDs.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRulesetRequest"
              },
              "example": {
                "code": "health-gap-ng-v1",
                "name": "Nigeria Health Gap Cover",
                "entity_type": "premium_rating",
                "description": "Pricing rules for health gap cover in Nigeria",
                "attributes": {
                  "jurisdiction": "NG",
                  "product_line": "health",
                  "effective_from": "2026-07-01"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Ruleset created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesetResponse"
                },
                "example": {
                  "data": {
                    "id": "rst_01abcdefghjkmnpqrstvwxyz01",
                    "code": "health-gap-ng-v1",
                    "name": "Nigeria Health Gap Cover",
                    "entity_type": "premium_rating",
                    "description": "Pricing rules for health gap cover in Nigeria",
                    "status": "draft",
                    "version": 1,
                    "attributes": {
                      "jurisdiction": "NG",
                      "product_line": "health",
                      "effective_from": "2026-07-01"
                    },
                    "rules": [],
                    "created_at": "2026-04-03T10:00:00Z",
                    "updated_at": "2026-04-03T10:00:00Z"
                  },
                  "status": "success",
                  "message": "Ruleset created successfully"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listRulesets",
        "x-axiom-substrate-kind": "ruleset",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "List rulesets",
        "description": "Retrieves a paginated list of rulesets for the current tenant.\n\nResults are sorted by `recorded_at` descending with the ruleset `id` as\na stable cursor tiebreaker. Legacy `limit` and `offset` query parameters\nare rejected; use `page[size]` and `page[after]`.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Maximum number of items to return (default 20, max 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "example": 20
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as `meta.next_cursor` from the previous page",
            "schema": {
              "type": "string",
              "example": "eyJyZWNvcmRlZF9hdCI6IjIwMjYtMDgtMTVUMTI6MDA6MDBaIiwiaWQiOiJiMWMyZDNlNC1mNWE2LTc4OTAtYmNkZS1mMTIzNDU2Nzg5MDEifQ"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of rulesets retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesetListResponse"
                },
                "example": {
                  "data": [
                    {
                      "id": "rst_01abcdefghjkmnpqrstvwxyz01",
                      "code": "motor-comprehensive-v1",
                      "name": "Motor Vehicle Rating Rules",
                      "entity_type": "pricing",
                      "description": "Validation and pricing rules for comprehensive motor insurance",
                      "status": "active",
                      "version": 3,
                      "attributes": {
                        "jurisdiction": "US",
                        "product_line": "motor"
                      },
                      "rules": null,
                      "created_at": "2026-01-10T08:00:00Z",
                      "updated_at": "2026-03-01T14:30:00Z"
                    },
                    {
                      "id": "rst_01abcdefghjkmnpqrstvwxyz01",
                      "code": "property-allrisks-gb-v1",
                      "name": "UK Property All-Risks",
                      "entity_type": "underwriting",
                      "description": "Validation and underwriting rules for all-risks property cover in the UK",
                      "status": "draft",
                      "version": 1,
                      "attributes": {
                        "jurisdiction": "GB",
                        "product_line": "property"
                      },
                      "rules": null,
                      "created_at": "2026-03-15T09:00:00Z",
                      "updated_at": "2026-03-15T09:00:00Z"
                    }
                  ],
                  "meta": {
                    "page_size": 20,
                    "has_more": false
                  },
                  "status": "success",
                  "message": "Rulesets retrieved successfully"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets/{id}": {
      "get": {
        "operationId": "getRuleset",
        "x-axiom-substrate-kind": "ruleset",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Get a ruleset by ID",
        "description": "Retrieves a single ruleset by its unique identifier, including\nall associated business rules.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Ruleset retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesetResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "put": {
        "operationId": "updateRuleset",
        "x-axiom-substrate-kind": "ruleset",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Update a ruleset",
        "description": "Updates the metadata of a ruleset (name, description, attributes).\n\nOnly rulesets in `draft` status can be updated. Active or deprecated\nrulesets are immutable \u2014 create a new version instead.\n\nThis does not modify individual rules. Use the rule-level endpoints\nto add, update, or remove rules.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Updated human-readable name",
                    "example": "Motor Vehicle Rating Rules (Updated)"
                  },
                  "description": {
                    "type": "string",
                    "description": "Updated description",
                    "example": "Validation, pricing, and eligibility rules for comprehensive motor insurance"
                  },
                  "attributes": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": true,
                    "description": "Updated metadata",
                    "example": {
                      "jurisdiction": "US",
                      "product_line": "motor",
                      "effective_from": "2026-04-01"
                    }
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ruleset updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesetResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets/{id}/test": {
      "post": {
        "operationId": "testRuleset",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Test a ruleset against input facts",
        "description": "Evaluates the entire ruleset against the provided input facts\nand returns the evaluation results.\n\nThis is a dry-run \u2014 no state is modified. The response includes\na full explanation tree showing which rules fired, their inputs,\nintermediate results, and final decisions (platform principle explainability).\n\nThe ruleset must be active before this endpoint runs. Testing a draft\nruleset returns `409 RULESET_NOT_ACTIVE`; use `/test-rule` for isolated\nexpression checks while authoring.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "facts"
                ],
                "properties": {
                  "facts": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Input facts for rule evaluation. Structure depends on the\nruleset's entity_type and the rules defined within it.\n",
                    "example": {
                      "applicant": {
                        "age": 32,
                        "licence_years": 10,
                        "prior_events_count": 0
                      },
                      "vehicle": {
                        "make": "Toyota",
                        "model": "Hilux",
                        "year_of_manufacture": 2023,
                        "value": 450000
                      },
                      "cover": {
                        "type": "comprehensive",
                        "sum_insured": 450000
                      }
                    }
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "facts": {
                  "applicant": {
                    "age": 32,
                    "licence_years": 10,
                    "prior_events_count": 0
                  },
                  "vehicle": {
                    "make": "Toyota",
                    "model": "Hilux",
                    "year_of_manufacture": 2023,
                    "value": 450000
                  },
                  "cover": {
                    "type": "comprehensive",
                    "sum_insured": 450000
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ruleset evaluation completed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesetEvaluationResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets/{id}/test-rule": {
      "post": {
        "operationId": "testSingleRule",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Test a single rule within a ruleset",
        "description": "Evaluates a single rule expression against the provided input facts.\nUseful for iterative rule development and debugging before the rule is\nadded to a ruleset.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "expression",
                  "data"
                ],
                "properties": {
                  "expression": {
                    "type": "string",
                    "description": "CEL expression to test.",
                    "example": "applicant.age >= 18"
                  },
                  "data": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Input facts for rule evaluation",
                    "example": {
                      "applicant": {
                        "age": 17,
                        "licence_years": 0
                      }
                    }
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "expression": "applicant.age >= 18",
                "data": {
                  "applicant": {
                    "age": 17,
                    "licence_years": 0
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Single rule evaluation completed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SingleRuleEvaluationResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets/{id}/deploy": {
      "post": {
        "operationId": "deployRuleset",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "ruleset-deployment",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Deploy a ruleset",
        "description": "Transitions a ruleset from `draft` to `active` status, making it\navailable for evaluation in live policy lifecycles, retained claim-family\ncompatibility lifecycles, and premium calculation pipelines.\n\nThis increments the ruleset version number. The previous active\nversion (if any) is transitioned to `deprecated` and retained\nfor as-was auditability.\n\nThis operation cannot be undone \u2014 to roll back, deploy the\nprevious version's rules in a new ruleset.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "activated_by"
                ],
                "properties": {
                  "activated_by": {
                    "type": "string",
                    "description": "Actor identifier recorded in the deployment audit trail.",
                    "example": "underwriter-user-003"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "activated_by": "underwriter-user-003"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Ruleset deployed successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesetResponse"
                },
                "example": {
                  "data": {
                    "id": "rst_01abcdefghjkmnpqrstvwxyz01",
                    "code": "health-gap-ng-v1",
                    "name": "Nigeria Health Gap Cover",
                    "entity_type": "pricing",
                    "description": "Pricing rules for health gap cover in Nigeria",
                    "status": "active",
                    "version": 2,
                    "attributes": {
                      "jurisdiction": "NG",
                      "product_line": "health",
                      "effective_from": "2026-07-01"
                    },
                    "created_at": "2026-04-03T10:00:00Z",
                    "updated_at": "2026-04-03T11:00:00Z"
                  },
                  "status": "success",
                  "message": "Ruleset deployed successfully"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets/{id}/rules": {
      "post": {
        "operationId": "addRule",
        "x-axiom-substrate-kind": "ruleset",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Add a rule to a ruleset",
        "description": "Adds a new business rule to a ruleset. The ruleset must be in\n`draft` status.\n\nRules are defined as CEL (Common Expression Language) expressions\nthat must be deterministic and side-effect free.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddBusinessRuleRequest"
              },
              "example": {
                "code": "max-vehicle-age",
                "name": "Maximum Vehicle Age",
                "rule_type": "validation",
                "expression": "vehicle.year_of_manufacture >= 2011",
                "description": "Vehicle must be no more than 15 years old for comprehensive cover in the test year",
                "priority": 20,
                "attributes": {
                  "risk_category": "vehicle_eligibility"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Rule added successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BusinessRuleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets/{id}/rules/{ruleId}": {
      "put": {
        "operationId": "updateRule",
        "x-axiom-substrate-kind": "ruleset",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Update a rule within a ruleset",
        "description": "Updates an existing business rule within a ruleset. The ruleset\nmust be in `draft` status.\n\nUpdatable fields: name, expression, priority, status, attributes.\n\n`status` is the sole optional controlling-state input. Omission preserves\nthe exact live stored state, including read-only historical inactive,\ndisabled and archived values. Explicit draft, active and deprecated values\naccept any ASCII letter case and are stored lowercase. Null, empty, padded,\nunknown or historical state values are rejected with 400. The field name\nmust be exactly `status`; duplicate controlling keys are rejected.\nAny `enabled` key (including null, false or a value agreeing with status)\nis rejected with 400. An explicit status on an archived rule returns 409;\nomission does not resurrect deleted rules or unarchive a rule.\nExpression validation retains its 422 errors. Genuine storage failures\nreturn sanitized 500 errors; missing tenant-scoped resources return 404.\nEach successful update records attributed before/after changes atomically\nin the tenant audit trail. Missing verified attribution returns 401 with\nACTOR_ATTRIBUTION_REQUIRED. Audit persistence failure returns sanitized\n503 with AUDIT_SINK_UNAVAILABLE and rolls back the rule and parent changes.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "name": "ruleId",
            "in": "path",
            "required": true,
            "description": "Typed rule identifier within the ruleset",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "not": {
                  "required": [
                    "enabled"
                  ]
                },
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Updated rule name",
                    "example": "Maximum Vehicle Age (Extended)"
                  },
                  "expression": {
                    "type": "string",
                    "description": "Updated CEL expression",
                    "example": "vehicle.year_of_manufacture >= 2006"
                  },
                  "priority": {
                    "type": "integer",
                    "description": "Updated execution priority",
                    "example": 20
                  },
                  "status": {
                    "type": "string",
                    "pattern": "^([dD][rR][aA][fF][tT]|[aA][cC][tT][iI][vV][eE]|[dD][eE][pP][rR][eE][cC][aA][tT][eE][dD])$",
                    "description": "Optional controlling state, ASCII case insensitive on ingress and\nstored lowercase. Omission preserves the raw live state.\nNull, whitespace and historical read-only values are invalid.\n"
                  },
                  "attributes": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "additionalProperties": true,
                    "description": "Updated metadata"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Rule updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BusinessRuleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "delete": {
        "operationId": "deleteRule",
        "x-axiom-substrate-kind": "ruleset",
        "x-axiom-substrate-id": "rulesets",
        "x-axiom-configurability": "tenant-rules",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Delete a rule from a ruleset",
        "description": "Removes a rule from a ruleset. The ruleset must be in `draft` status.\n\nRules in active or deprecated rulesets cannot be deleted \u2014 deprecate\nthe rule instead to preserve the audit trail.\n",
        "tags": [
          "Ruleset"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed ruleset identifier",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01",
              "format": "typed-prefix-id",
              "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
              "x-axiom-identifier-classification": "ruleset-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "name": "ruleId",
            "in": "path",
            "required": true,
            "description": "Typed rule identifier within the ruleset",
            "schema": {
              "type": "string",
              "example": "rst_01abcdefghjkmnpqrstvwxyz01"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Rule deleted successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RulesetDeleteRuleResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/evidence": {
      "post": {
        "operationId": "createEvidenceRecord",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "evidence-records-and-packs",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Create an evidence record",
        "description": "Creates a new evidence record capturing a decision, evaluation, or\nstate transition for audit and compliance purposes.\n\nEvidence records are immutable once created. The `content_hash` (SHA-256)\nis computed server-side and enables tamper detection.\n\nSupports platform principle (Explainability) \u2014 every material decision emits a durable\nexplanation tree stored as evidence.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEvidenceRecordRequest"
              },
              "example": {
                "record_type": "rule_evaluation",
                "subject_type": "policy",
                "subject_id": "pol_01K4Q5JPSVE28X56H7E2D8EMBS",
                "content": {
                  "evaluation": "premium_calculation",
                  "inputs": {
                    "vehicle_value": 450000,
                    "driver_age": 32,
                    "prior_events_count": 0,
                    "region": "New York"
                  },
                  "rule_version": "motor-pricing-v2.0.1",
                  "base_premium": 8100,
                  "loadings": [],
                  "discounts": [
                    {
                      "type": "event_free_rating_discount",
                      "percentage": 0.2
                    }
                  ],
                  "final_premium": 6480
                },
                "created_by": "pricing-engine"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Evidence record created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateEvidenceRecordResponse"
                },
                "example": {
                  "status": "success",
                  "data": {
                    "id": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                    "type": "evidence",
                    "attributes": {
                      "evidence_id": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                      "content_hash": "3a7bd3e2e2d5f90c1e9b3c8a4d6f7e8b9a0c1d2e3f4567890abcdef12345678",
                      "canonicalization_version": "jcs-rfc8785-v1"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/evidence/{evidence_id}": {
      "get": {
        "operationId": "getEvidenceRecord",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "evidence-records-and-packs",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Get an evidence record by ID",
        "description": "Returns a single evidence record including its full content payload\nand integrity hash.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "evidence_id",
            "in": "path",
            "required": true,
            "description": "Evidence record typed-prefix identifier.",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
          }
        ],
        "responses": {
          "200": {
            "description": "Evidence record",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EvidenceRecordResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/evidence/query": {
      "post": {
        "operationId": "queryEvidence",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "evidence-records-and-packs",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Query evidence records",
        "description": "Searches evidence records using structured filters. Supports filtering\nby subject, record type, date range, and content attributes.\n\nPOST is used instead of GET to support complex query payloads\nthat exceed URL length limits.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "subject_type": {
                    "type": "string",
                    "description": "Filter by subject type",
                    "example": "assertion"
                  },
                  "subject_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "description": "Filter by subject identifier",
                    "example": "pol_01K4Q5JPSVE28X56H7E2D8EMBS",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "record_type": {
                    "type": "string",
                    "description": "Filter by evidence record type",
                    "example": "decision_trace"
                  },
                  "from_date": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Filter records created on or after this timestamp",
                    "example": "2026-03-01T00:00:00Z"
                  },
                  "to_date": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Filter records created before this timestamp",
                    "example": "2026-03-12T23:59:59Z"
                  },
                  "page_size": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100,
                    "default": 20,
                    "description": "Maximum number of records to return"
                  },
                  "page_after": {
                    "type": "string",
                    "description": "Opaque cursor returned by the previous evidence page."
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "subject_type": "assertion",
                "subject_id": "pol_01K4Q5JPSVE28X56H7E2D8EMBS",
                "record_type": "decision_trace",
                "from_date": "2026-03-01T00:00:00Z",
                "limit": 50
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Matching evidence records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueryEvidenceResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/evidence/{evidence_id}/integrity-verifications": {
      "post": {
        "operationId": "verifyEvidenceIntegrity",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "evidence-records-and-packs",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Verify integrity of a single evidence record",
        "description": "Recomputes the content hash for the specified evidence record and\ncompares it against the stored hash. Returns a verification result\nindicating whether the record has been tampered with.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "evidence_id",
            "in": "path",
            "required": true,
            "description": "Evidence record typed-prefix identifier to verify.",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
          }
        ],
        "responses": {
          "201": {
            "description": "Integrity verification result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrityVerificationResponse"
                },
                "example": {
                  "status": "success",
                  "data": {
                    "id": "eig_01K4Q5K0SCWMJ40BWEFG0C29EM",
                    "type": "integrity-verification",
                    "attributes": {
                      "verification_id": "eig_01K4Q5K0SCWMJ40BWEFG0C29EM",
                      "expected_hash": "3a7bd3e2e2d5f90c1e9b3c8a4d6f7e8b9a0c1d2e3f4567890abcdef12345678",
                      "actual_hash": "3a7bd3e2e2d5f90c1e9b3c8a4d6f7e8b9a0c1d2e3f4567890abcdef12345678",
                      "status": "verified",
                      "verified_at": "2026-03-12T10:20:00Z"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/evidence/verify": {
      "post": {
        "operationId": "verifyEvidence",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "evidence-records-and-packs",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Batch-verify evidence record integrity",
        "description": "Verifies the integrity of multiple evidence records in a single request.\nUseful for periodic compliance audits or spot checks.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "record_ids": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "typed-prefix-id"
                    },
                    "description": "List of evidence record typed-prefix IDs to verify",
                    "minItems": 1,
                    "maxItems": 100
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "record_ids": [
                  "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                  "evd_01K4Q5K9CNKPV5E3R2EEDJQJ1F",
                  "evd_01K4Q5KDYH8SR16VJEKETX1V50"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Batch verification results",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerifyEvidenceResponse"
                },
                "example": {
                  "status": "success",
                  "data": [
                    {
                      "record_id": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                      "content_hash": "3a7bd3e2e2d5f90c1e9b3c8a4d6f7e8b9a0c1d2e3f4567890abcdef12345678",
                      "status": "VERIFIED"
                    },
                    {
                      "record_id": "evd_01K4Q5K9CNKPV5E3R2EEDJQJ1F",
                      "content_hash": "4a7bd3e2e2d5f90c1e9b3c8a4d6f7e8b9a0c1d2e3f4567890abcdef12345678",
                      "status": "TAMPERED"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/evidence-packs/assemble": {
      "post": {
        "operationId": "assembleEvidencePack",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "evidence-records-and-packs",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Assemble an evidence pack",
        "description": "Assembles a collection of evidence records into a named pack.\nEvidence packs provide a complete audit trail for a decision or event,\nbundling all related records for compliance reporting and review.\n\nunder the governed contract, packs are assembled on demand from existing records\nand are themselves immutable once created.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssembleEvidencePackRequest"
              },
              "example": {
                "name": "Claim CLM-2026-00142 \u2014 Marine Cargo Adjudication Evidence Pack",
                "record_ids": [
                  "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                  "evd_01K4Q5K9CNKPV5E3R2EEDJQJ1F"
                ],
                "assembled_by": "compliance-reporting-service"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Evidence pack assembled",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EvidencePackResource"
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/evidence-packs/{pack_id}": {
      "get": {
        "operationId": "getEvidencePack",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "evidence-records-and-packs",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Get an evidence pack by ID",
        "description": "Returns an evidence pack including all constituent evidence records.\n",
        "tags": [
          "Evidence"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "pack_id",
            "in": "path",
            "required": true,
            "description": "Evidence pack typed-prefix identifier.",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "evp_01K4Q5K4MHXSFKQ62B8NQ58WG1"
          }
        ],
        "responses": {
          "200": {
            "description": "Evidence pack with records",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/EvidencePackResource"
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/compliance/evaluations/{evaluation_id}/report": {
      "get": {
        "operationId": "getComplianceReport",
        "summary": "Get a compliance evaluation report",
        "description": "Returns a compliance report for a completed evaluation, including\nper-jurisdiction findings, pack metadata, and explanation tree reference.\n\nunder the governed contract: compliance_assertion is always false \u2014 reports are\nevidence-enabling, not compliance-asserting.\n",
        "tags": [
          "Compliance"
        ],
        "security": [
          {
            "BearerAuth": [
              "compliance:read"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "evaluation_id",
            "in": "path",
            "required": true,
            "description": "Compliance evaluation UUID",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "compliance-evaluation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "example": "cmp_eval_20260408_0001"
          }
        ],
        "responses": {
          "200": {
            "description": "Compliance evaluation report",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ComplianceReportResponse"
                },
                "example": {
                  "data": {
                    "evaluation_id": "cmp_eval_20260408_0001",
                    "generated_at": "2026-04-08T12:00:05Z",
                    "compliance_assertion": false,
                    "findings": [
                      {
                        "jurisdiction_code": "ZA",
                        "status": "pass",
                        "evidence_references": [
                          "cmp_eval_20260408_0001"
                        ],
                        "missing_evidence": []
                      }
                    ],
                    "ruleset_metadata": [
                      {
                        "pack_id": "cmp_pack_20260408_0001",
                        "pack_version": "1.0.0"
                      }
                    ],
                    "explanation_tree_id": "cmp_tree_20260408_0001"
                  },
                  "status": "success"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "compliance:read"
          ],
          "required_permissions": [
            "compliance:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/vendors": {
      "post": {
        "operationId": "createVendor",
        "summary": "Register a new vendor",
        "description": "Creates a vendor record for a third-party service provider.\n\nVendors represent external organisations that process, store, or access\ntenant data. Each vendor is tracked for compliance purposes (POPIA, GDPR)\nincluding data classification, security review status, and subprocessor chains.\n\nRequest and response use JSON:API envelope format.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateVendorRequest"
              },
              "example": {
                "data": {
                  "type": "vendors",
                  "attributes": {
                    "name": "MediCheck Health Services",
                    "purpose": "Medical underwriting and claims verification for health insurance products",
                    "classification": "C",
                    "accessed_data_classes": [
                      "health",
                      "personal_identifiable"
                    ],
                    "integrations": [
                      {
                        "system_name": "MediCheck Claims API",
                        "data_categories": [
                          "health_records"
                        ],
                        "data_direction": "ingress",
                        "transfer_method": "rest_api"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Vendor created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorDataEnvelope"
                },
                "example": {
                  "data": {
                    "type": "vendors",
                    "attributes": {
                      "vendor_id": "vnd_01abcdefghjkmnpqrstvwxyz01",
                      "name": "MediCheck Health Services",
                      "purpose": "Medical underwriting and claims verification for health insurance products",
                      "classification": "C",
                      "accessed_data_classes": [
                        "health",
                        "personal_identifiable"
                      ],
                      "status": "draft",
                      "integrations": [
                        {
                          "integration_id": "vnd_01abcdefghjkmnpqrstvwxyz01",
                          "vendor_id": "vnd_01abcdefghjkmnpqrstvwxyz01",
                          "system_name": "MediCheck Claims API",
                          "data_categories": [
                            "health_records"
                          ],
                          "data_direction": "ingress",
                          "transfer_method": "rest_api"
                        }
                      ],
                      "security_review_status": "pending",
                      "security_review_approved_at": null,
                      "created_at": "2026-03-12T10:00:00Z",
                      "updated_at": "2026-03-12T10:00:00Z"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listVendors",
        "summary": "List vendors",
        "description": "Returns a paginated list of vendor records for the tenant.\n\nSupports cursor-based pagination via `page[size]` and `page[after]` query parameters.\nResponse uses a JSON:API-style collection envelope with `data` array and `meta` object.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Maximum number of vendors to return (default 20, max 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Opaque cursor for next page; obtained from previous response meta.next_cursor",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of vendors",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Vendor"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page_size": {
                          "type": "integer"
                        },
                        "next_cursor": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "data": [
                    {
                      "vendor_id": "vnd_01abcdefghjkmnpqrstvwxyz01",
                      "name": "MediCheck Health Services",
                      "purpose": "Medical underwriting and claims verification",
                      "classification": "C",
                      "accessed_data_classes": [
                        "health",
                        "personal_identifiable"
                      ],
                      "status": "active",
                      "created_at": "2026-02-01T09:00:00Z",
                      "updated_at": "2026-03-05T16:20:00Z"
                    },
                    {
                      "vendor_id": "vnd_01abcdefghjkmnpqrstvwxyz01",
                      "name": "SafePay Financial Gateway",
                      "purpose": "Premium collection and payment processing",
                      "classification": "B",
                      "accessed_data_classes": [
                        "financial",
                        "personal_identifiable"
                      ],
                      "status": "active",
                      "created_at": "2025-11-15T10:00:00Z",
                      "updated_at": "2026-02-28T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "page_size": 20,
                    "next_cursor": ""
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/vendors/{vendor_id}": {
      "get": {
        "operationId": "getVendor",
        "summary": "Get a vendor by ID",
        "description": "Returns the full vendor record including integrations and subprocessors.\nResponse uses JSON:API envelope format.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "vendor_id",
            "in": "path",
            "required": true,
            "description": "Typed vendor identifier",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "vnd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          }
        ],
        "responses": {
          "200": {
            "description": "Vendor record",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorDataEnvelope"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "patch": {
        "operationId": "updateVendor",
        "summary": "Update a vendor",
        "description": "Partially updates a vendor record. Only provided fields are modified.\nSecurity-review status is not accepted on this endpoint; use the\nauthorized security-review decision endpoint.\nRequest and response use JSON:API envelope format.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "vendor_id",
            "in": "path",
            "required": true,
            "description": "Typed vendor identifier",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "vnd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateVendorRequest"
              },
              "example": {
                "data": {
                  "type": "vendors",
                  "attributes": {
                    "status": "active"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Vendor updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorDataEnvelope"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/vendors/{vendor_id}/security-review-decisions": {
      "post": {
        "operationId": "decideVendorSecurityReview",
        "x-axiom-substrate-kind": "lifecycle",
        "x-axiom-substrate-id": "vendor-security-review-lifecycle",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Record an authorized vendor security-review decision",
        "description": "Records a security-review decision for a vendor through an explicitly\nauthorized attestation workflow. Ordinary vendor updates cannot change\n`security_review_status`.\n\nRequest and response use JSON:API envelope format.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "vendor_id",
            "in": "path",
            "required": true,
            "description": "Typed vendor identifier",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "vnd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VendorSecurityReviewDecisionRequest"
              },
              "example": {
                "data": {
                  "type": "vendor-security-review-decisions",
                  "attributes": {
                    "status": "approved",
                    "decision_basis": "SOC 2 Type II report and security questionnaire reviewed"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Security-review decision recorded successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorDataEnvelope"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/vendors/{vendor_id}/subprocessors": {
      "post": {
        "operationId": "createSubprocessor",
        "summary": "Add a subprocessor to a vendor",
        "description": "Registers a subprocessor under a vendor. Subprocessors are third parties\nthat the vendor engages to process data on behalf of the tenant.\n\nTracking subprocessors is required for POPIA and GDPR compliance, ensuring\nthe full data processing chain is documented and approved.\n\nRequest and response use JSON:API envelope format.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "vendor_id",
            "in": "path",
            "required": true,
            "description": "Parent vendor UUID",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "vnd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSubprocessorRequest"
              },
              "example": {
                "data": {
                  "type": "subprocessors",
                  "attributes": {
                    "name": "Azure US East",
                    "service_scope": "Disaster recovery and backup storage for policy documents"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Subprocessor created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubprocessorDataEnvelope"
                },
                "example": {
                  "data": {
                    "type": "subprocessors",
                    "attributes": {
                      "subprocessor_id": "vnd_01abcdefghjkmnpqrstvwxyz01",
                      "vendor_id": "vnd_01abcdefghjkmnpqrstvwxyz01",
                      "name": "Azure US East",
                      "service_scope": "Disaster recovery and backup storage for policy documents",
                      "approval_status": "pending",
                      "approved_by": null,
                      "approved_at": null,
                      "change_reason": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/vendors/{vendor_id}/subprocessors/{subprocessor_id}": {
      "patch": {
        "operationId": "updateSubprocessor",
        "summary": "Update a subprocessor",
        "description": "Partially updates a subprocessor record under a vendor.\nApproval status is not accepted on this endpoint; use the authorized\nsubprocessor approval decision endpoint.\n\nRequest and response use JSON:API envelope format.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "vendor_id",
            "in": "path",
            "required": true,
            "description": "Parent vendor UUID",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "vnd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          },
          {
            "name": "subprocessor_id",
            "in": "path",
            "required": true,
            "description": "Subprocessor UUID",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^sub_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "sub_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-subprocessor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSubprocessorRequest"
              },
              "example": {
                "data": {
                  "type": "subprocessors",
                  "attributes": {
                    "change_reason": "Updated service scope after annual review"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Subprocessor updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubprocessorDataEnvelope"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/vendors/{vendor_id}/subprocessors/{subprocessor_id}/approval-decisions": {
      "post": {
        "operationId": "decideSubprocessorApproval",
        "x-axiom-substrate-kind": "lifecycle",
        "x-axiom-substrate-id": "vendor-subprocessor-approval-lifecycle",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Record an authorized subprocessor approval decision",
        "description": "Records a subprocessor approval decision through an explicitly authorized\nattestation workflow. Ordinary subprocessor create and update requests\ncannot set approval status, approver, or approval timestamp.\n\nRequest and response use JSON:API envelope format.\n",
        "tags": [
          "Vendor"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "vendor_id",
            "in": "path",
            "required": true,
            "description": "Parent vendor UUID",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "vnd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          },
          {
            "name": "subprocessor_id",
            "in": "path",
            "required": true,
            "description": "Subprocessor UUID",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^sub_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "sub_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "vendor-subprocessor-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubprocessorApprovalDecisionRequest"
              },
              "example": {
                "data": {
                  "type": "subprocessor-approval-decisions",
                  "attributes": {
                    "status": "approved",
                    "decision_basis": "DPA and subprocessor security evidence accepted"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Subprocessor approval decision recorded successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubprocessorDataEnvelope"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/cover-balances": {
      "get": {
        "operationId": "getPolicyCoverBalance",
        "summary": "Get approved cover consumption for a policy",
        "description": "Computes sum_amount or distinct approved assertion-item count for this policy and tenant cover-item code. Period filters apply to current approved facts; they are not historical reconstruction of mutable assertion rows. Clinical quantity/day/out-of-pocket computations and policy_object_id are unsupported. No as_of query parameter is implemented.",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed policy identity.",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "name": "cover_type",
            "in": "query",
            "required": true,
            "description": "Tenant cover-item code.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "period_start",
            "in": "query",
            "required": true,
            "description": "Inclusive period start (RFC3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "period_end",
            "in": "query",
            "required": true,
            "description": "Inclusive period end (RFC3339); availability resolves the bound policy version at this timestamp.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "decompose",
            "in": "query",
            "required": false,
            "description": "Include constituent explanation.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "computation",
            "in": "query",
            "required": false,
            "description": "Supported assertion-item computation.",
            "schema": {
              "type": "string",
              "enum": [
                "sum_amount",
                "count_events"
              ],
              "default": "sum_amount"
            }
          },
          {
            "name": "as_of_mode",
            "in": "query",
            "required": false,
            "description": "Service-date mode uses assertion-item service_date, parent event_date, then parent created_at. Processing-time mode uses parent created_at.",
            "schema": {
              "type": "string",
              "enum": [
                "service_date",
                "processing_time"
              ],
              "default": "service_date"
            }
          },
          {
            "name": "cover_id",
            "in": "query",
            "required": false,
            "description": "Canonical cover-item identity; retained query name.",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "name": "party_id",
            "in": "query",
            "required": false,
            "description": "Primary party identity.",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pty_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "party-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "name": "event_id",
            "in": "query",
            "required": false,
            "description": "Parent event identity.",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "event-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "subcategory",
            "in": "query",
            "required": false,
            "description": "Tenant item subtype.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Canonical cover-balance response.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "required": [
                            "policy_id",
                            "benefit_type",
                            "period_start",
                            "period_end",
                            "currency",
                            "benefits_used",
                            "value",
                            "claim_item_count"
                          ],
                          "properties": {
                            "policy_id": {
                              "type": "string",
                              "description": "Typed policy identity.",
                              "format": "typed-prefix-id",
                              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
                              "example": "pol_01arz3ndektsv4rrffq69g5fav",
                              "x-axiom-identifier-classification": "policy-id",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "benefit_type": {
                              "type": "string",
                              "description": "Retained response key containing the requested tenant cover-item code."
                            },
                            "period_start": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "period_end": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "currency": {
                              "type": "string",
                              "pattern": "^[a-z]{3}$",
                              "example": "zar"
                            },
                            "benefits_used": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Sum of approved assertion-item amounts. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "value": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Computed sum; for count_events this is the distinct item count. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "computation_type": {
                              "type": "string",
                              "enum": [
                                "sum_amount",
                                "count_events"
                              ]
                            },
                            "annual_limit": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Resolved bound cover limit after applicable proration; omitted when not resolved. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "available": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Non-negative limit minus approved consumption; omitted when no limit is configured. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "claim_item_count": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "limit_resolution": {
                              "type": "object",
                              "description": "Resolved bound policy-version and term provenance. Present for availability queries.",
                              "properties": {
                                "found": {
                                  "type": "boolean"
                                },
                                "policy_version_id": {
                                  "type": "string",
                                  "format": "typed-prefix-id",
                                  "x-axiom-identifier-shape": "typed-prefix"
                                },
                                "as_of": {
                                  "type": "string",
                                  "format": "date-time"
                                }
                              },
                              "additionalProperties": true
                            },
                            "explanation": {
                              "type": "object",
                              "description": "Query inputs, deterministic assertion-item identities and computation; emitted when decompose=true.",
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "cover_type",
            "period_start",
            "period_end",
            "decompose",
            "computation",
            "as_of_mode",
            "cover_id",
            "party_id",
            "event_id",
            "subcategory"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/cover-balances/available": {
      "get": {
        "operationId": "getPolicyCoverBalanceAvailable",
        "summary": "Get available cover amount for a policy",
        "description": "Resolves limit terms from the immutable bound policy-version cover snapshot, computes approved consumption, and applies relevant proration components. This read does not subtract pending reserve amounts; reserve admission has its own atomic capacity path. Missing currency or version authority fails explicitly.",
        "tags": [
          "Policy"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Typed policy identity.",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "name": "cover_type",
            "in": "query",
            "required": true,
            "description": "Tenant cover-item code.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "period_start",
            "in": "query",
            "required": true,
            "description": "Inclusive period start (RFC3339).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "period_end",
            "in": "query",
            "required": true,
            "description": "Inclusive period end (RFC3339); availability resolves the bound policy version at this timestamp.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "decompose",
            "in": "query",
            "required": false,
            "description": "Include constituent explanation.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Canonical cover-balance response.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "required": [
                            "policy_id",
                            "benefit_type",
                            "period_start",
                            "period_end",
                            "currency",
                            "benefits_used",
                            "value",
                            "claim_item_count"
                          ],
                          "properties": {
                            "policy_id": {
                              "type": "string",
                              "description": "Typed policy identity.",
                              "format": "typed-prefix-id",
                              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
                              "example": "pol_01arz3ndektsv4rrffq69g5fav",
                              "x-axiom-identifier-classification": "policy-id",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "benefit_type": {
                              "type": "string",
                              "description": "Retained response key containing the requested tenant cover-item code."
                            },
                            "period_start": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "period_end": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "currency": {
                              "type": "string",
                              "pattern": "^[a-z]{3}$",
                              "example": "zar"
                            },
                            "benefits_used": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Sum of approved assertion-item amounts. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "value": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Computed sum; for count_events this is the distinct item count. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "computation_type": {
                              "type": "string",
                              "enum": [
                                "sum_amount",
                                "count_events"
                              ]
                            },
                            "annual_limit": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Resolved bound cover limit after applicable proration; omitted when not resolved. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "available": {
                              "type": "string",
                              "pattern": "^-?[0-9]+$",
                              "description": "Non-negative limit minus approved consumption; omitted when no limit is configured. Exact integer minor units encoded as a string.",
                              "x-axiom-money-classification": "decimal-string-alpha-exception",
                              "x-axiom-money-currency-association": "currency",
                              "x-axiom-money-migration-target": "#/components/schemas/Money"
                            },
                            "claim_item_count": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "limit_resolution": {
                              "type": "object",
                              "description": "Resolved bound policy-version and term provenance. Present for availability queries.",
                              "properties": {
                                "found": {
                                  "type": "boolean"
                                },
                                "policy_version_id": {
                                  "type": "string",
                                  "format": "typed-prefix-id",
                                  "x-axiom-identifier-shape": "typed-prefix"
                                },
                                "as_of": {
                                  "type": "string",
                                  "format": "date-time"
                                }
                              },
                              "additionalProperties": true
                            },
                            "explanation": {
                              "type": "object",
                              "description": "Query inputs, deterministic assertion-item identities and computation; emitted when decompose=true.",
                              "additionalProperties": true
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "cover_type",
            "period_start",
            "period_end",
            "decompose"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/premiums/proration-balances": {
      "get": {
        "description": "Read a tenant-owned policy-scoped balance derived from accepted proration decision components for implemented governed contract proration consumers. Slice 1 supports fund and earning balances; treaty-scoped reinsurance balances fail closed until governed treaty authority exists.",
        "operationId": "getProrationBalance",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Policy ID in pol_ wire form.",
            "in": "query",
            "name": "policy_id",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Implemented proration balance consumer. `reinsurance_balance` is an accepted fail-closed value until governed treaty authority exists.\n",
            "in": "query",
            "name": "consumer",
            "required": true,
            "schema": {
              "enum": [
                "fund_balance",
                "earning_balance",
                "reinsurance_balance"
              ],
              "type": "string"
            }
          },
          {
            "description": "Inclusive balance period start.",
            "in": "query",
            "name": "period_start",
            "required": true,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "description": "Exclusive balance period end.",
            "in": "query",
            "name": "period_end",
            "required": true,
            "schema": {
              "format": "date-time",
              "type": "string"
            }
          },
          {
            "description": "Fund account code, required for fund_balance unless account_code is supplied.",
            "in": "query",
            "name": "fund_account_code",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Generic account code for fund or earning balance scope.",
            "in": "query",
            "name": "account_code",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Earning period key, required for earning_balance unless account_code is supplied.",
            "in": "query",
            "name": "earning_period_key",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include constituent proration component IDs and operation details.",
            "in": "query",
            "name": "decompose",
            "required": false,
            "schema": {
              "default": false,
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProrationBalanceResponse"
                }
              }
            },
            "description": "Proration balance result."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "policies:read"
            ]
          }
        ],
        "summary": "Get Proration Balance",
        "tags": [
          "Premium",
          "Policy",
          "Cover"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "policy_id",
            "consumer",
            "period_start",
            "period_end",
            "fund_account_code",
            "account_code",
            "earning_period_key",
            "decompose"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "policies:read"
          ],
          "required_permissions": [
            "policies:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/analytics/dashboard": {
      "get": {
        "operationId": "getDashboardMetrics",
        "x-axiom-runtime-availability": {
          "status": "unavailable",
          "reason": "Runtime analytics handler returns 501 until tenant-owned analytics projections are implemented.",
          "source": "runtime source"
        },
        "summary": "Get dashboard metrics",
        "description": "Published for route accountability in API 0.1.0. The runtime currently\nreturns 501 until tenant-owned analytics projections are implemented.\n",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "501": {
            "description": "Dashboard analytics is not implemented in API 0.1.0.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "501",
                      "code": "NOT_IMPLEMENTED",
                      "title": "Not Implemented",
                      "detail": "Not implemented"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "limited",
          "published": true,
          "authorisation": "not-callable-until-runtime-support-lands",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Published for route accountability in API 0.2.126; this operation returns 501 until runtime support lands."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/analytics/claims-by-status": {
      "get": {
        "operationId": "getClaimsByStatus",
        "x-axiom-runtime-availability": {
          "status": "unavailable",
          "reason": "Runtime analytics handler returns 501 until tenant-owned analytics projections are implemented.",
          "source": "runtime source"
        },
        "summary": "Get retained claim-family status breakdown",
        "description": "Published for route accountability in API 0.1.0. The route name and\noperationId are retained public compatibility identifiers over\nevent/assertion status analytics. The runtime currently returns 501 until\ntenant-owned analytics projections are implemented.\n",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "501": {
            "description": "Retained claim-family status analytics is not implemented in API 0.1.0.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "501",
                      "code": "NOT_IMPLEMENTED",
                      "title": "Not Implemented",
                      "detail": "Not implemented"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "limited",
          "published": true,
          "authorisation": "not-callable-until-runtime-support-lands",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Published for route accountability in API 0.2.126; this operation returns 501 until runtime support lands."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/analytics/monthly-revenue": {
      "get": {
        "operationId": "getMonthlyRevenue",
        "x-axiom-runtime-availability": {
          "status": "unavailable",
          "reason": "Runtime analytics handler returns 501 until tenant-owned analytics projections are implemented.",
          "source": "runtime source"
        },
        "summary": "Get monthly revenue trend",
        "description": "Published for route accountability in API 0.1.0. The runtime currently\nreturns 501 until tenant-owned analytics projections are implemented.\n",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "501": {
            "description": "Monthly-revenue analytics is not implemented in API 0.1.0.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "501",
                      "code": "NOT_IMPLEMENTED",
                      "title": "Not Implemented",
                      "detail": "Not implemented"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "limited",
          "published": true,
          "authorisation": "not-callable-until-runtime-support-lands",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Published for route accountability in API 0.2.126; this operation returns 501 until runtime support lands."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/analytics/top-products": {
      "get": {
        "operationId": "getTopProducts",
        "x-axiom-runtime-availability": {
          "status": "unavailable",
          "reason": "Runtime analytics handler returns 501 until tenant-owned analytics projections are implemented.",
          "source": "runtime source"
        },
        "summary": "Get top products by premium volume",
        "description": "Published for route accountability in API 0.1.0. The runtime currently\nreturns 501 until tenant-owned analytics projections are implemented.\n",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "501": {
            "description": "Top-products analytics is not implemented in API 0.1.0.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "501",
                      "code": "NOT_IMPLEMENTED",
                      "title": "Not Implemented",
                      "detail": "Not implemented"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "limited",
          "published": true,
          "authorisation": "not-callable-until-runtime-support-lands",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Published for route accountability in API 0.2.126; this operation returns 501 until runtime support lands."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/reports/export": {
      "get": {
        "operationId": "exportReport",
        "x-axiom-runtime-availability": {
          "status": "unavailable",
          "reason": "No admitted report-runner runtime owner exists for API 0.1.0; governed contract tenant-owned projections, versioned metric definitions, evidence references and explanation references remain required before beta-facing export.",
          "source": "docs/reference/shape-contract-corpus/specs/s2-reporting-analytics-contract.md",
          "metadata_schema_version": "axiom.report-export.unavailable.v1",
          "evidence_ref": "docs/reference/shape-contract-corpus/specs/s2-reporting-analytics-contract.md",
          "explanation_ref": "docs/audits/search-reporting-analytics-read-models/remediation/evidence/AUD-SEARCH-REPORTING-ANALYTICS-READ-MODELS-0005.md",
          "freshness_status": "unavailable",
          "redaction_posture": "not-run-no-export-payload",
          "consumer_metadata": "report-runner-not-admitted"
        },
        "summary": "Export a report",
        "description": "Published for route accountability in API 0.1.0. The runtime currently\nreturns 501 until the tenant-owned report-runner substrate is implemented.\n\nSupported report types:\n- `premium_collection` \u2014 Premium collection summary by product and period\n- `claims_register` \u2014 Claims register with status, amounts, and settlement details\n- `loss_ratio` \u2014 Loss ratio analysis by product line\n- `policy_register` \u2014 Policy register with coverage and premium details\n- `reconciliation` \u2014 Ledger reconciliation report\n- `commission_statement` \u2014 Broker commission statement\n\nWhen implemented, successful responses will return report file content\nrather than a JSON envelope. API 0.1.0 does not yet publish that runtime\npromise.\n",
        "tags": [
          "Report"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "description": "Request correlation ID for tracing",
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": true,
            "description": "Report type to generate",
            "schema": {
              "type": "string",
              "enum": [
                "premium_collection",
                "claims_register",
                "loss_ratio",
                "policy_register",
                "reconciliation",
                "commission_statement"
              ],
              "example": "premium_collection"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": true,
            "description": "Output format for the report",
            "schema": {
              "type": "string",
              "enum": [
                "pdf",
                "csv"
              ],
              "example": "pdf"
            }
          },
          {
            "name": "date_from",
            "in": "query",
            "required": false,
            "description": "Start date for the report period (inclusive, ISO 8601 date)",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-01-01"
            }
          },
          {
            "name": "date_to",
            "in": "query",
            "required": false,
            "description": "End date for the report period (inclusive, ISO 8601 date)",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-03-31"
            }
          },
          {
            "name": "product_code",
            "in": "query",
            "required": false,
            "description": "Filter report to a specific product code",
            "schema": {
              "type": "string",
              "example": "motor-comprehensive"
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Currency for monetary amounts (defaults to tenant base currency)",
            "schema": {
              "type": "string",
              "pattern": "^[A-Z]{3}$",
              "example": "USD"
            }
          }
        ],
        "responses": {
          "400": {
            "description": "Invalid report parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "400",
                      "code": "INVALID_REQUEST",
                      "title": "Invalid request",
                      "detail": "unknown report type \"unknown\"",
                      "meta": {
                        "schema_version": "axiom.report-export.unavailable.v1",
                        "requested_type": "unknown",
                        "accepted_types": [
                          "premium_collection",
                          "claims_register",
                          "loss_ratio",
                          "policy_register",
                          "reconciliation",
                          "commission_statement"
                        ],
                        "evidence_ref": "docs/reference/shape-contract-corpus/specs/s2-reporting-analytics-contract.md",
                        "explanation_ref": "docs/audits/search-reporting-analytics-read-models/remediation/evidence/AUD-SEARCH-REPORTING-ANALYTICS-READ-MODELS-0005.md",
                        "freshness_status": "unavailable",
                        "degraded": true,
                        "redaction_posture": "not-run-no-export-payload",
                        "consumer_metadata": "report-runner-not-admitted",
                        "runtime_authority": "no-admitted-report-runner",
                        "availability_state": "unavailable"
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "501": {
            "description": "Report export is not implemented in API 0.1.0.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "501",
                      "code": "NOT_IMPLEMENTED",
                      "title": "Not Implemented",
                      "detail": "Report export is unavailable until the tenant-owned report-runner substrate is implemented.",
                      "meta": {
                        "schema_version": "axiom.report-export.unavailable.v1",
                        "requested_type": "premium_collection",
                        "accepted_types": [
                          "premium_collection",
                          "claims_register",
                          "loss_ratio",
                          "policy_register",
                          "reconciliation",
                          "commission_statement"
                        ],
                        "evidence_ref": "docs/reference/shape-contract-corpus/specs/s2-reporting-analytics-contract.md",
                        "explanation_ref": "docs/audits/search-reporting-analytics-read-models/remediation/evidence/AUD-SEARCH-REPORTING-ANALYTICS-READ-MODELS-0005.md",
                        "freshness_status": "unavailable",
                        "degraded": true,
                        "redaction_posture": "not-run-no-export-payload",
                        "consumer_metadata": "report-runner-not-admitted",
                        "runtime_authority": "no-admitted-report-runner",
                        "availability_state": "unavailable"
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "limited",
          "published": true,
          "authorisation": "not-callable-until-runtime-support-lands",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Published for route accountability in API 0.2.126; this operation returns 501 until runtime support lands."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "type",
            "format",
            "date_from",
            "date_to",
            "product_code",
            "currency"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/inbox/messages": {
      "post": {
        "description": "Contract authority for POST /v1/inbox/messages (receiveInboxMessage) in the Events/Assertions portfolio. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "receiveInboxMessage",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "mailroom:inbox:read"
            ]
          }
        ],
        "summary": "Receive Inbox Message",
        "tags": [
          "Event"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "nonstandard",
          "scopes": [
            "mailroom:inbox:read"
          ],
          "required_permissions": [
            "mailroom:inbox:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ],
          "scope_exception": "One or more published scope names do not use the canonical resource:action form in API 0.2.126."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ingress/events": {
      "post": {
        "operationId": "ingestEvent",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "ingress-event-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Ingest an event",
        "description": "Receives an event into the Axiom ingress pipeline for asynchronous\nvalidation and processing.\n\nThis is an admitted alpha transport surface for asynchronous external\ninputs. It persists a durable inbox record and a tenant-scoped status\nrecord before returning 202 Accepted. `202 Accepted` means durable\nreceipt only. It does not mean the submitted event is valid, accepted\ninto the insurance domain, processed, or linked downstream.\n\nCallers must use the returned `status_url` or subscribe to a governed\nnotification channel when available. Polling the status endpoint is the\nauthoritative way to discover later validation and processing outcomes.\n\nIt is not a public self-service event catalogue, and event-type schemas\nare not yet published as a generated contract fragment. Event types,\npayload schemas, and promotion rules are tenant-owned configuration when\npromoted; they are not Axiom-owned public domain content.\n\n**Conditional availability:** This endpoint may return 404 if async\ningress is not enabled in the environment.\n\n**Response format:** JSON:API style \u2014 not the legacy wrapper.\n\n**Idempotency:** Events are deduplicated using `X-Webhook-Delivery-ID`\nwhen supplied. If the header is absent, the runtime derives a stable key\nfrom the source and request body bytes. Resubmitting the same key returns\nthe original `ingress_id`, current receipt status, and `status_url`.\n",
        "tags": [
          "Ingress"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "event_type",
                  "payload"
                ],
                "properties": {
                  "event_type": {
                    "type": "string",
                    "description": "Tenant-owned external event type identifier. The public\ndeveloper-preview contract does not publish a stable event\ntype catalogue; use only values supplied in an issued tenant\nintegration runbook.\n",
                    "example": "external.event.received"
                  },
                  "source": {
                    "type": "string",
                    "description": "Optional source hint. The runtime may derive source from the\nauthenticated context or `X-Source` header.\n",
                    "example": "external-ingress"
                  },
                  "occurred_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "When the event actually occurred (as opposed to when it was\nreceived). If omitted, the server uses the receipt timestamp.\n",
                    "example": "2026-03-12T09:30:00Z"
                  },
                  "payload": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Tenant-owned boundary payload. Structure varies by event_type.\nNo public self-service payload schema catalogue is published\nin API 0.1.0. Treat payload shape as tenant-issued integration\nconfiguration, not Axiom-owned domain content.\n"
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Optional event metadata (routing hints, trace context)"
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "event_received": {
                  "summary": "External event received",
                  "value": {
                    "event_type": "external.event.received",
                    "source": "external-ingress",
                    "occurred_at": "2026-03-12T09:30:00Z",
                    "payload": {
                      "external_reference": "event-2026-03-12-001",
                      "occurred_at": "2026-03-12T09:30:00Z",
                      "attributes": {
                        "status": "received"
                      }
                    }
                  }
                },
                "event_with_metadata": {
                  "summary": "External event with metadata",
                  "value": {
                    "event_type": "external.event.updated",
                    "source": "external-ingress",
                    "occurred_at": "2026-03-12T06:00:00Z",
                    "payload": {
                      "external_reference": "event-2026-03-12-002",
                      "attributes": {
                        "status": "updated"
                      }
                    },
                    "metadata": {
                      "import_batch": "batch-2026-03-12"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Event submission durably received for asynchronous validation.\n\nThis response means receipt only. The caller must inspect\n`status_url` to determine whether validation later failed, the event\nbecame accepted for domain processing, or processing completed.\n",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "required": [
                        "status",
                        "ingress_id",
                        "status_url",
                        "correlation_id",
                        "idempotency_key",
                        "received_at"
                      ],
                      "properties": {
                        "status": {
                          "type": "string",
                          "enum": [
                            "received"
                          ],
                          "description": "Initial mailroom status. Receipt has been persisted; domain acceptance has not yet been proven."
                        },
                        "ingress_id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "description": "Assigned ingress record typed-prefix identifier",
                          "example": "iir_01arz3ndektsv4rrffq69g5fav",
                          "pattern": "^iir_[0-9a-hjkmnp-tv-z]{26}$",
                          "x-axiom-identifier-classification": "ingress-inbox-record-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "status_url": {
                          "type": "string",
                          "description": "Relative URL for tenant-scoped polling of validation and processing state",
                          "example": "/v1/ingress/events/iir_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
                        },
                        "correlation_id": {
                          "type": "string",
                          "description": "Correlation ID for tracing this event through the pipeline",
                          "x-axiom-identifier-classification": "correlation-id",
                          "x-axiom-identifier-shape": "opaque-string"
                        },
                        "idempotency_key": {
                          "type": "string",
                          "description": "Echo of the supplied or runtime-derived idempotency key"
                        },
                        "received_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Server-side receipt timestamp"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "data": {
                    "status": "received",
                    "ingress_id": "iir_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                    "status_url": "/v1/ingress/events/iir_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                    "correlation_id": "corr_20260408_0001",
                    "idempotency_key": "external-ingress:event-2026-03-12-001",
                    "received_at": "2026-03-12T09:30:05Z"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Async ingress is not enabled for the admitted environment.\nContact support to enable it.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "errors": [
                    {
                      "status": "404",
                      "code": "FEATURE_DISABLED",
                      "title": "Not Found",
                      "detail": "Event ingress is not enabled in this environment"
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "published-429-response",
            "headers": [
              "Retry-After",
              "X-RateLimit-Limit",
              "X-RateLimit-Remaining",
              "X-RateLimit-Reset"
            ],
            "numeric_commitment": "tenant-policy-runtime",
            "limit_source": "active tenant rate_limit_policies.limit",
            "window_source": "active tenant rate_limit_policies.window_secs",
            "enforcement": "gateway-rate-limit-runtime"
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/ingress/events/{ingress_id}": {
      "get": {
        "operationId": "getIngressEventStatus",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "ingress-event-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Get ingress event status",
        "description": "Returns the tenant-scoped status trail for an asynchronous event\nsubmission.\n\nUse this endpoint after `POST /v1/ingress/events` returns `202 Accepted`.\nThe status endpoint is authoritative: webhook or email notification\ndelivery can fail without hiding the validation result from the caller.\n\nStatus separates receipt, validation, domain acceptance, processing, and\ncompletion:\n\n- `received` means Axiom has durably received the submission.\n- `validation_failed` means the submission failed asynchronous validation.\n- `accepted` means validation has passed far enough for domain processing.\n- `processing_failed` means domain processing failed after acceptance.\n- `completed` means processing completed and any resulting domain\n  reference is visible in the response where available.\n\nNo domain event or assertion exists until the ingress record reaches an\naccepted/processing/completed state.\n",
        "tags": [
          "Ingress"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "ingress_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^iir_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "iir_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "ingress-inbox-record-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Assigned ingress record typed-prefix identifier returned by `POST /v1/ingress/events`.",
            "example": "iir_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
          }
        ],
        "responses": {
          "200": {
            "description": "Current tenant-scoped ingress status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "required": [
                        "id",
                        "status",
                        "status_url",
                        "submitted_at",
                        "updated_at",
                        "event_type",
                        "correlation_id",
                        "idempotency_key"
                      ],
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "example": "iir_01arz3ndektsv4rrffq69g5fav",
                          "pattern": "^iir_[0-9a-hjkmnp-tv-z]{26}$",
                          "x-axiom-identifier-classification": "ingress-inbox-record-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "received",
                            "queued",
                            "validating",
                            "validation_failed",
                            "accepted",
                            "processing",
                            "processing_failed",
                            "completed",
                            "expired",
                            "cancelled",
                            "dead_lettered"
                          ]
                        },
                        "stage": {
                          "type": "string",
                          "description": "Current validation or processing stage where applicable",
                          "example": "url_validation"
                        },
                        "status_url": {
                          "type": "string",
                          "description": "Relative URL for this status resource",
                          "example": "/v1/ingress/events/iir_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
                        },
                        "submitted_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "updated_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "event_type": {
                          "type": "string"
                        },
                        "correlation_id": {
                          "type": "string",
                          "x-axiom-identifier-classification": "correlation-id",
                          "x-axiom-identifier-shape": "opaque-string"
                        },
                        "idempotency_key": {
                          "type": "string"
                        },
                        "domain_event_id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Resulting domain event identifier when processing has created one"
                        },
                        "errors": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/IngressStatusError"
                          }
                        },
                        "events": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/IngressStatusTrailEvent"
                          }
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "data": {
                    "id": "iir_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                    "status": "validation_failed",
                    "stage": "url_validation",
                    "status_url": "/v1/ingress/events/iir_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                    "submitted_at": "2026-03-12T09:30:05Z",
                    "updated_at": "2026-03-12T09:30:08Z",
                    "event_type": "external.event.received",
                    "correlation_id": "corr_20260408_0001",
                    "idempotency_key": "external-ingress:event-2026-03-12-001",
                    "errors": [
                      {
                        "code": "URL_UNREACHABLE",
                        "message": "The supplied evidence URL could not be reached within the validation window.",
                        "field": "payload.evidence_url",
                        "retryable": true
                      }
                    ],
                    "events": [
                      {
                        "status": "received",
                        "stage": "receipt",
                        "recorded_at": "2026-03-12T09:30:05Z",
                        "correlation_id": "corr_20260408_0001"
                      },
                      {
                        "status": "validation_failed",
                        "stage": "url_validation",
                        "recorded_at": "2026-03-12T09:30:08Z",
                        "correlation_id": "corr_20260408_0001",
                        "errors": [
                          {
                            "code": "URL_UNREACHABLE",
                            "message": "The supplied evidence URL could not be reached within the validation window.",
                            "field": "payload.evidence_url",
                            "retryable": true
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "published-429-response",
            "headers": [
              "Retry-After",
              "X-RateLimit-Limit",
              "X-RateLimit-Remaining",
              "X-RateLimit-Reset"
            ],
            "numeric_commitment": "tenant-policy-runtime",
            "limit_source": "active tenant rate_limit_policies.limit",
            "window_source": "active tenant rate_limit_policies.window_secs",
            "enforcement": "gateway-rate-limit-runtime"
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/communication-templates": {
      "post": {
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256
            }
          }
        ],
        "security": [
          {
            "BearerAuth": [
              "communication-templates:write"
            ]
          }
        ],
        "operationId": "createCommunicationTemplate",
        "summary": "Create and publish a tenant-owned communication template",
        "description": "Atomically creates a template and immutable revision 1 in the operating tenant. The authenticated actor supplies attribution. Identical same-key replay returns the original 201; a changed body returns 409. Every declared channel requires a rendering. Returns a small committed-revision acknowledgement; retrieve full content through the current or pinned GET operation.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommunicationTemplateCreateRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Committed revision acknowledgement; GET returns complete content.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunicationTemplateMutationEnvelope"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "communication-templates:write"
          ],
          "required_permissions": [
            "communication-templates:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/communication-templates/{template_code}": {
      "get": {
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "template_code",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^[a-z0-9][a-z0-9._-]*$"
            }
          },
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          }
        ],
        "security": [
          {
            "BearerAuth": [
              "communication-templates:read"
            ]
          }
        ],
        "operationId": "getCommunicationTemplate",
        "summary": "Retrieve the complete current template revision",
        "description": "Returns metadata, schemas, channels and rendering bodies for the operating tenant. No resource in another tenant is resolved.",
        "responses": {
          "200": {
            "description": "Complete immutable template revision.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunicationTemplateEnvelope"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "communication-templates:read"
          ],
          "required_permissions": [
            "communication-templates:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/communication-templates/{template_code}/revisions/{version}/render": {
      "post": {
        "description": "Read-only deterministic preview of an immutable operating-tenant revision. Flat string personalisation uses only {{name}} identifiers matching [A-Za-z_][A-Za-z0-9_]{0,63}; no expressions or execution. Validates the stored schema without external references. Returns byte digests and pinned provenance; creates no archive, communication or delivery records. Each value is limited to 65536 UTF-8 bytes, aggregate key/value input to 262144 bytes, stored source to 1048576 bytes, and each rendered body or subject to 2097152 bytes. Duplicate object keys, case-variant wire fields, malformed Unicode and overlapping placeholder delimiters are refused. The complete raw JSON request body is independently limited to 1048576 bytes, including JSON escaping and whitespace; exceeding this wire limit returns 400 INVALID_TEMPLATE_RENDER_INPUT before schema validation.",
        "operationId": "renderCommunicationTemplateRevision",
        "parameters": [
          {
            "description": "Path parameter `template_code`.",
            "in": "path",
            "name": "template_code",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Positive integer path parameter `version`.",
            "in": "path",
            "name": "version",
            "required": true,
            "schema": {
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommunicationTemplateRenderRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunicationTemplateRenderEnvelope"
                }
              }
            },
            "description": "Deterministic preview and pinned provenance."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "communication-templates:read"
            ]
          }
        ],
        "summary": "Render a pinned communication template revision",
        "tags": [
          "Communications"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "communication-templates:read"
          ],
          "required_permissions": [
            "communication-templates:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/communication-templates/{template_code}/revisions": {
      "post": {
        "description": "Append a complete immutable successor in the operating tenant and atomically publish its pointer. The expected current revision must still match; stale authors receive 409 with no partial successor. Authenticated attribution and tenant-scoped idempotent replay are required.",
        "operationId": "createCommunicationTemplateRevision",
        "parameters": [
          {
            "description": "Path parameter `template_code`.",
            "in": "path",
            "name": "template_code",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommunicationTemplateRevisionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunicationTemplateMutationEnvelope"
                }
              }
            },
            "description": "Immutable successor appended and published; small acknowledgement, with complete content available through GET."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "communication-templates:write"
            ]
          }
        ],
        "summary": "Append and publish a communication template revision",
        "tags": [
          "Communications"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "communication-templates:write"
          ],
          "required_permissions": [
            "communication-templates:write"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/communication-templates/{template_code}/revisions/{version}": {
      "get": {
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "template_code",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^[a-z0-9][a-z0-9._-]*$"
            }
          },
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "in": "path",
            "name": "version",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        ],
        "security": [
          {
            "BearerAuth": [
              "communication-templates:read"
            ]
          }
        ],
        "operationId": "getCommunicationTemplateRevision",
        "summary": "Retrieve a pinned immutable template revision",
        "description": "Returns the exact requested version and the current publication pointer in the operating tenant. A missing version returns 404.",
        "responses": {
          "200": {
            "description": "Complete immutable template revision.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommunicationTemplateEnvelope"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "communication-templates:read"
          ],
          "required_permissions": [
            "communication-templates:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/communications/{communication_id}": {
      "get": {
        "operationId": "getCommunication",
        "summary": "Fetch a communication with its storage leg, legs and observations",
        "description": "Returns the communication, the live state of its storage leg\n(`archive_state`, `archive_id` null until bound), each party-side leg\nwith its delivery observations, and endpoint-level state such as a\ncarrier read receipt (governed contract). Tenant-scoped.\n",
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "in": "path",
            "name": "communication_id",
            "required": true,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "opaque-resource-id",
              "x-axiom-identifier-shape": "alpha-exception",
              "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
            },
            "description": "The communication id returned by `POST /v1/communications`."
          }
        ],
        "responses": {
          "200": {
            "description": "The communication and its delivery state.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CommunicationDetail"
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/carriers/{carrier}/{receiver_key}": {
      "parameters": [
        {
          "in": "path",
          "name": "carrier",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Must equal the resolved configuration's `carrier_kind`. Known value:\n`whatsapp`; an unknown carrier is refused with the same 403.\n"
        },
        {
          "in": "path",
          "name": "receiver_key",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Opaque address of a tenant carrier configuration\n(`communication.carrier_config.receiver_key`). An address, not a\ncredential. 32\u201364 characters `[A-Za-z0-9_-]`; a malformed key is\ntreated as unknown and refused with the same 403.\n"
        }
      ],
      "get": {
        "operationId": "verifyCarrierReceiptSubscription",
        "summary": "Carrier receipt subscription handshake",
        "description": "For WhatsApp, Meta's webhook verification: echoes `hub.challenge`\nonly for `hub.mode=subscribe` and a constant-time match of\n`hub.verify_token` against the configuration's verify token (an\nOpenBao reference). Any other request returns the same refusal as a\nfailed POST, persists nothing and emits a security event.\n",
        "security": [
          {
            "CarrierReceiptVerifyToken": []
          }
        ],
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "hub.mode",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "hub.verify_token",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "hub.challenge",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The `hub.challenge` value, verbatim.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "hub.mode",
            "hub.verify_token",
            "hub.challenge"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "not-required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "not-applicable",
          "tenant_context": "not-required",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "carrier-verify-token-verification"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "published-429-response",
            "headers": [
              "Retry-After",
              "X-RateLimit-Limit",
              "X-RateLimit-Remaining",
              "X-RateLimit-Reset"
            ],
            "numeric_commitment": "tenant-policy-runtime",
            "limit_source": "active tenant rate_limit_policies.limit",
            "window_source": "active tenant rate_limit_policies.window_secs",
            "enforcement": "gateway-rate-limit-runtime"
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "not-required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "receiveCarrierReceipts",
        "summary": "Receive carrier delivery receipts",
        "description": "Carrier receipts through the Mailroom Inbox (governed contract).\nProcessing order is fixed: reject a body over the receiver size\nlimit; resolve the receiver key to its tenant's active configurations\nand their shared signing context; load the signing secret from\nOpenBao; for WhatsApp, verify `X-Hub-Signature-256` (HMAC-SHA256 of\nthe raw body) in constant time; only then parse or persist. An\nunknown or disabled key, an unavailable signing secret, a carrier/key\nmismatch, an oversize body or a bad signature returns the same 403\n`ErrorResponse`; missing or\nmalformed parameters are refused with the same 403. Every accepted\nbody is persisted as an insert-only Mailroom Inbox record keyed by its\ndigest; 2xx is returned only after that commit. A repeated body\nreturns 2xx and changes nothing. Status entries are promoted from the\ncommitted record: `delivered`/`failed` to `delivery_attempt`, `read` to\n`endpoint_state_observation`, `sent` kept as Inbox evidence. No entry's\npromotion outcome changes the HTTP response. `Idempotency-Key` is\nexempt; the body-digest replay guard replaces it.\n",
        "security": [
          {
            "CarrierReceiptSignature": []
          }
        ],
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "in": "header",
            "name": "X-Hub-Signature-256",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "For WhatsApp, the provider signature over the raw request body\n(`sha256=<hex>`). A missing or malformed value is refused with the\nsame 403 as a bad signature.\n"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": true,
                "description": "Provider webhook body (Meta WhatsApp Cloud API `whatsapp_business_account` object)."
              },
              "example": {
                "object": "whatsapp_business_account",
                "entry": [
                  {
                    "id": "100000000000001",
                    "changes": [
                      {
                        "field": "messages",
                        "value": {
                          "messaging_product": "whatsapp",
                          "metadata": {
                            "display_phone_number": "27800000000",
                            "phone_number_id": "100000000000002"
                          },
                          "statuses": [
                            {
                              "id": "wamid.EXAMPLE",
                              "status": "delivered",
                              "timestamp": "1793770000",
                              "recipient_id": "27820000001",
                              "biz_opaque_callback_data": "cdp_01arz3ndektsv4rrffq69g5fav:1"
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Accepted and committed to the Mailroom Inbox (or a repeated body).",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "accepted",
                            "replayed"
                          ],
                          "properties": {
                            "accepted": {
                              "type": "boolean"
                            },
                            "replayed": {
                              "type": "boolean"
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "not-required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "not-applicable",
          "tenant_context": "not-required",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "carrier-request-signature-verification"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "published-429-response",
            "headers": [
              "Retry-After",
              "X-RateLimit-Limit",
              "X-RateLimit-Remaining",
              "X-RateLimit-Reset"
            ],
            "numeric_commitment": "tenant-policy-runtime",
            "limit_source": "active tenant rate_limit_policies.limit",
            "window_source": "active tenant rate_limit_policies.window_secs",
            "enforcement": "gateway-rate-limit-runtime"
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "not-required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/carrier-configs": {
      "post": {
        "operationId": "createCarrierConfig",
        "summary": "Configure a carrier for a message class and locale",
        "description": "Tenant carrier configuration (governed contract). Non-secret settings\nonly: credentials are OpenBao references under\n`tenants/{tenant context}/`. The provider API host is fixed by the platform.\nThe tenant records its POPIA governed contract-governed contract operator agreement and, when the\nprovider processes outside the Republic, its governed contract transfer basis.\nConfigurations of one tenant on the same provider number and signing\ncontext share one receiver key; the response returns the receiver path\nto register with the provider.\n",
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 256
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CarrierConfigRequest"
              },
              "example": {
                "carrier_kind": "whatsapp",
                "provider": "meta_cloud_api",
                "message_class": "policy-bound",
                "locale": "en",
                "api_version": "v21.0",
                "phone_number_id": "100000000000002",
                "business_account_id": "100000000000001",
                "template_name": "policy_bound_notice",
                "template_language": "en",
                "template_parameter_count": 3,
                "access_token_ref": "tenants/{tenant context}/whatsapp/access-token",
                "app_secret_ref": "tenants/{tenant context}/whatsapp/app-secret",
                "verify_token_ref": "tenants/{tenant context}/whatsapp/verify-token",
                "max_attempts": 3,
                "retry_base_seconds": 30,
                "request_timeout_seconds": 10,
                "dispatch_batch_size": 10,
                "delivery_deadline_seconds": 3600,
                "receipt_window_seconds": 86400,
                "operator_agreement_ref": "meta-whatsapp-business-data-processing-terms-2026",
                "processes_outside_republic": true,
                "transfer_basis": "popia-72-1-a"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Configuration created.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CarrierConfig"
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/carrier-configs/{carrier_config_id}": {
      "get": {
        "operationId": "getCarrierConfig",
        "summary": "Read a carrier configuration",
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CarrierConfigID"
          }
        ],
        "responses": {
          "200": {
            "description": "The configuration.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CarrierConfig"
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/carrier-configs/{carrier_config_id}/disable": {
      "post": {
        "operationId": "disableCarrierConfig",
        "summary": "Disable a carrier configuration",
        "description": "The only change a configuration accepts: active to disabled. A\nconfiguration is never edited in place; a change disables the old one\nand creates a new one. Open legs bound to a disabled configuration\ndead-letter with `CARRIER_NOT_CONFIGURED` at their next dispatch pass\n(governed contract). Disabling an already disabled configuration\nreturns 409.\n",
        "tags": [
          "Communications"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CarrierConfigID"
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 256
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The disabled configuration.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CarrierConfig"
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{partyId}/consent-grants": {
      "post": {
        "description": "Record a consent grant for a Party, including a channel opt-in scoped to channels, message classes and a contact (governed contract).",
        "operationId": "createConsentGrant",
        "parameters": [
          {
            "description": "Path parameter `partyId`.",
            "in": "path",
            "name": "partyId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateConsentGrantRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConsentGrantResponse"
                }
              }
            },
            "description": "Consent grant"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "parties:manage-consent"
            ]
          }
        ],
        "summary": "Record Party Consent Grant",
        "tags": [
          "Party",
          "consent"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "parties:manage-consent"
          ],
          "required_permissions": [
            "parties:manage-consent"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{partyId}/consent-grants/{grantId}/withdraw": {
      "post": {
        "description": "Withdraw a Party consent grant: close its `valid_to` at `withdrawn_at`, one way, and record `revocation_reason` on the grant (POPIA s11(2)(b)); no closure row is appended.",
        "operationId": "withdrawConsentGrant",
        "parameters": [
          {
            "description": "Path parameter `partyId`.",
            "in": "path",
            "name": "partyId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Path parameter `grantId`.",
            "in": "path",
            "name": "grantId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Idempotency key (scope: tenant).",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WithdrawConsentGrantRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConsentGrantResponse"
                }
              }
            },
            "description": "Consent grant"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "parties:manage-consent"
            ]
          }
        ],
        "summary": "Withdraw Party Consent Grant",
        "tags": [
          "Party",
          "consent"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "parties:manage-consent"
          ],
          "required_permissions": [
            "parties:manage-consent"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/webhook-endpoints": {
      "post": {
        "operationId": "registerWebhookEndpoint",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "webhook-delivery-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Register a webhook endpoint",
        "description": "Registers or updates a tenant-scoped outbound webhook endpoint.\n\nThis is an alpha transport-configuration surface governed by the\nMailroom transport registry, not an ordinary product API operation.\nIt records where outbound webhook deliveries may be sent, which\ncarrier delivers them, and how the delivery should be authenticated.\n\n`carrier` is required, has no default and is fixed at registration:\nre-registering the same `name` with a different carrier is a `409`\n`IMMUTABLE_FIELD_CONFLICT`.\n- `http_webhook`: HTTP POST of the event envelope, authenticated per\n  `auth_method`.\n- `xero_manual_journal`: posts each subscribed finance event's ledger\n  lines as one Xero manual journal (governed contract). The `url` must be\n  `https://api.xero.com/api.xro/2.0/ManualJournals` and `auth_method`\n  must be `none`; the endpoint authenticates through its Xero\n  connection (`PUT /v1/mailroom/webhook-endpoints/{endpoint_id}/connection`).\n\nEvent subscriptions are tenant-owned configuration held apart from\nregistration (`PUT /v1/mailroom/webhook-endpoints/{endpoint_id}/subscriptions`).\nDo not send `event_types`, event schemas, routing rules, ordering keys,\nor replay policy in this request.\n\nSecrets are supplied by reference only. Do not send raw secret material\nin the request body.\n\nFor `auth_method=hmac_sha256`, each outbound delivery includes:\n- `X-Axiom-Event-Id`: the typed `oev_` canonical event id (governed contract).\n  It is also the payload `event_id`.\n- `X-Axiom-Delivery-Id`: typed `whd_` durable delivery id.\n- `X-Correlation-ID`: support trace id for the delivery workflow.\n- `X-Webhook-Timestamp`: Unix seconds in UTC.\n- `X-Webhook-Signature`: `sha256=<hex>` where the digest is\n  `HMAC-SHA256(secret, X-Webhook-Timestamp + \".\" + raw request body bytes)`.\n\nReceivers should reject missing, malformed, stale, or mismatched\nsignatures before processing the payload. A five-minute replay window is\nthe alpha recommendation unless the issued integration runbook specifies\na stricter tenant policy.\n\nOutbound webhook delivery is at-least-once. Exactly-once delivery,\nglobal ordering, and per-endpoint ordering are not guaranteed in the\nalpha public contract. Receivers dedupe on the `oev_` event id in\n`X-Axiom-Event-Id`: it is stable across retries, consumer redelivery and\nendpoints for one event, and one endpoint receives at most one delivery\nrecord per event. The `X-Axiom-Delivery-Id` is reused across retry\nattempts for one delivery record only; it is not an event id. Receivers\nmust be idempotent and tolerate duplicate, delayed, and out-of-order\ndeliveries. A `xero_manual_journal` endpoint sends the `oev_` id as the\nXero `Idempotency-Key`.\n\n**Response format:** Canonical success envelope.\n",
        "tags": [
          "Webhook"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "url",
                  "auth_method",
                  "carrier",
                  "max_retries",
                  "backoff_seconds"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64,
                    "pattern": "^[a-zA-Z0-9_-]+$",
                    "description": "Tenant-scoped endpoint name. Reusing the same name updates\nmutable endpoint settings.\n",
                    "example": "primary-events"
                  },
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "description": "HTTPS endpoint URL where webhook payloads will be delivered.\nRuntime validation rejects non-HTTPS URLs and known private,\nloopback, link-local, and non-routable targets.\n",
                    "example": "https://receiver.example.com/axiom/webhooks"
                  },
                  "description": {
                    "type": "string",
                    "description": "Human-readable description of this endpoint's purpose.",
                    "example": "Primary outbound event receiver"
                  },
                  "auth_method": {
                    "type": "string",
                    "enum": [
                      "hmac_sha256",
                      "bearer_token_ref",
                      "none"
                    ],
                    "default": "hmac_sha256",
                    "description": "Authentication method for webhook deliveries.\n- hmac_sha256: HMAC signature over timestamp and raw body bytes.\n- bearer_token_ref: bearer token resolved from auth_secret_ref at dispatch time.\n- none: unsigned delivery; admitted only where tenant policy allows it.\n",
                    "example": "hmac_sha256"
                  },
                  "carrier": {
                    "type": "string",
                    "enum": [
                      "http_webhook",
                      "xero_manual_journal"
                    ],
                    "description": "How the dispatcher delivers to this endpoint. Required; no\ndefault; fixed at registration. A `xero_manual_journal`\nendpoint must use the Xero ManualJournals URL and\n`auth_method: none`.\n",
                    "example": "http_webhook"
                  },
                  "auth_secret_ref": {
                    "type": "string",
                    "writeOnly": true,
                    "description": "Opaque secret reference resolved by the Mailroom dispatcher.\nRequired when auth_method is hmac_sha256 or bearer_token_ref.\nRaw secret material must not be sent in this field.\n",
                    "example": "ref:webhooks/primary-events-signing-key"
                  },
                  "enabled": {
                    "type": "boolean",
                    "default": true,
                    "description": "Whether the endpoint is active"
                  },
                  "max_retries": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10,
                    "description": "Number of retry attempts after the first delivery attempt.",
                    "example": 3
                  },
                  "backoff_seconds": {
                    "type": "array",
                    "description": "Retry backoff values in seconds. The array length must equal\nmax_retries; each value must be between 1 and 3600 seconds.\n",
                    "items": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 3600
                    },
                    "example": [
                      10,
                      30,
                      60
                    ]
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "hmac_endpoint": {
                  "summary": "HMAC-signed endpoint",
                  "value": {
                    "name": "primary-events",
                    "url": "https://receiver.example.com/axiom/webhooks",
                    "description": "Primary outbound event receiver",
                    "auth_method": "hmac_sha256",
                    "auth_secret_ref": "ref:webhooks/primary-events-signing-key",
                    "carrier": "http_webhook",
                    "max_retries": 3,
                    "backoff_seconds": [
                      10,
                      30,
                      60
                    ],
                    "enabled": true
                  }
                },
                "unsigned_endpoint": {
                  "summary": "Unsigned endpoint admitted by tenant policy",
                  "value": {
                    "name": "test-events",
                    "url": "https://receiver.example.com/axiom/test-webhooks",
                    "description": "Test event receiver",
                    "auth_method": "none",
                    "carrier": "http_webhook",
                    "max_retries": 0,
                    "backoff_seconds": [],
                    "enabled": false
                  }
                },
                "xero_endpoint": {
                  "summary": "Xero manual-journal endpoint",
                  "value": {
                    "name": "general-ledger",
                    "url": "https://api.xero.com/api.xro/2.0/ManualJournals",
                    "auth_method": "none",
                    "carrier": "xero_manual_journal",
                    "max_retries": 3,
                    "backoff_seconds": [
                      30,
                      120,
                      600
                    ],
                    "enabled": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Webhook endpoint updated idempotently.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "id",
                            "name",
                            "url",
                            "auth_method",
                            "carrier",
                            "max_retries",
                            "backoff_seconds",
                            "enabled",
                            "created_at",
                            "updated_at"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "description": "Assigned typed webhook-endpoint identifier.",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "name": {
                              "type": "string",
                              "description": "Tenant-scoped endpoint name."
                            },
                            "url": {
                              "type": "string",
                              "format": "uri"
                            },
                            "description": {
                              "type": "string"
                            },
                            "auth_method": {
                              "type": "string",
                              "enum": [
                                "hmac_sha256",
                                "bearer_token_ref",
                                "none"
                              ]
                            },
                            "carrier": {
                              "type": "string",
                              "enum": [
                                "http_webhook",
                                "xero_manual_journal"
                              ]
                            },
                            "max_retries": {
                              "type": "integer"
                            },
                            "backoff_seconds": {
                              "type": "array",
                              "items": {
                                "type": "integer"
                              }
                            },
                            "enabled": {
                              "type": "boolean"
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "updated_at": {
                              "type": "string",
                              "format": "date-time"
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "201": {
            "description": "Webhook endpoint registered.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "id",
                            "name",
                            "url",
                            "auth_method",
                            "carrier",
                            "max_retries",
                            "backoff_seconds",
                            "enabled",
                            "created_at",
                            "updated_at"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "description": "Assigned typed webhook-endpoint identifier.",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "name": {
                              "type": "string",
                              "description": "Tenant-scoped endpoint name."
                            },
                            "url": {
                              "type": "string",
                              "format": "uri"
                            },
                            "description": {
                              "type": "string"
                            },
                            "auth_method": {
                              "type": "string",
                              "enum": [
                                "hmac_sha256",
                                "bearer_token_ref",
                                "none"
                              ]
                            },
                            "carrier": {
                              "type": "string",
                              "enum": [
                                "http_webhook",
                                "xero_manual_journal"
                              ]
                            },
                            "max_retries": {
                              "type": "integer"
                            },
                            "backoff_seconds": {
                              "type": "array",
                              "items": {
                                "type": "integer"
                              }
                            },
                            "enabled": {
                              "type": "boolean"
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "updated_at": {
                              "type": "string",
                              "format": "date-time"
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                },
                "example": {
                  "data": {
                    "id": "whe_7f8a9b0c1d234567890abcdef0123456",
                    "name": "primary-events",
                    "url": "https://receiver.example.com/axiom/webhooks",
                    "description": "Primary outbound event receiver",
                    "auth_method": "hmac_sha256",
                    "carrier": "http_webhook",
                    "max_retries": 3,
                    "backoff_seconds": [
                      10,
                      30,
                      60
                    ],
                    "enabled": true,
                    "created_at": "2026-03-12T12:30:00Z",
                    "updated_at": "2026-03-12T12:30:00Z"
                  },
                  "status": "success"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/webhook-endpoints/{endpoint_id}/subscriptions": {
      "put": {
        "operationId": "setWebhookEndpointSubscriptions",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "webhook-delivery-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Set a webhook endpoint's event subscriptions",
        "description": "Replaces the endpoint's enabled subscription set (governed contract Rev 8).\nSubscriptions are tenant-owned configuration held apart from endpoint\nregistration. Listed types are enabled; every other previously\nsubscribed type is disabled in place. Send `[]` to disable every\nsubscription. Repeating a request is a no-op.\n\nOnly types in the closed registry of subscribable event types are\nadmitted: `premium.collected`, `payment.disbursed` and\n`assertion.settlement_approved`. A ledger carrier\n(`xero_manual_journal`) accepts only events that carry a posted\njournal. An unknown type is `UNKNOWN_EVENT_TYPE` and a type the\ncarrier cannot carry is `EVENT_TYPE_HAS_NO_JOURNAL`; both name the\ntypes the endpoint's carrier accepts, and neither writes anything.\n\nEach delivery carries the typed `oev_` event id in\n`X-Axiom-Event-Id` and the payload `event_id`; receivers dedupe on it.\n\n**Response format:** Canonical success envelope.\n",
        "tags": [
          "Webhook"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "endpoint_id",
            "in": "path",
            "required": true,
            "description": "Typed webhook-endpoint identifier.",
            "schema": {
              "type": "string",
              "pattern": "^whe_[A-Za-z0-9_-]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "whe_7f8a9b0c1d234567890abcdef0123456"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "event_types"
                ],
                "properties": {
                  "event_types": {
                    "type": "array",
                    "uniqueItems": true,
                    "items": {
                      "type": "string",
                      "enum": [
                        "premium.collected",
                        "payment.disbursed",
                        "assertion.settlement_approved"
                      ]
                    }
                  }
                }
              },
              "example": {
                "event_types": [
                  "premium.collected",
                  "payment.disbursed"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The endpoint's enabled subscription set, in registry order.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "endpoint_id",
                            "event_types"
                          ],
                          "properties": {
                            "endpoint_id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "event_types": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                },
                "example": {
                  "data": {
                    "endpoint_id": "whe_7f8a9b0c1d234567890abcdef0123456",
                    "event_types": [
                      "premium.collected",
                      "payment.disbursed"
                    ]
                  },
                  "status": "success"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/webhook-endpoints/{endpoint_id}/connection": {
      "put": {
        "operationId": "putWebhookEndpointConnection",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "webhook-delivery-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Bind a webhook endpoint to its external organisation",
        "description": "Binds a vendor-protocol endpoint to the external organisation its\ncarrier posts to (governed contract Rev 4). The endpoint's carrier decides\nthe connection kind; today only `xero_manual_journal` has one, where\n`external_organisation_id` is the Xero organisation (tenant) id. Any\nother carrier is `CARRIER_HAS_NO_CONNECTION`.\n\n`credential_ref` is derived by the server as\n`<operating tenant uuid>/xero/<connection id>` and returned, so the\noperator knows which OpenBao path (relative to the connector mount) to\nseed with the OAuth2 credentials. It is never client-supplied, can only\nname the operating tenant's own path, and is stable across later PUTs.\nSecret material is never sent to or returned by this API.\n\nThe organisation is fixed once set: repeating the same\n`external_organisation_id` is a no-op; a different one is a `409`\n`IMMUTABLE_FIELD_CONFLICT` (register a new endpoint instead).\n\n**Response format:** Canonical success envelope.\n",
        "tags": [
          "Webhook"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "endpoint_id",
            "in": "path",
            "required": true,
            "description": "Typed webhook-endpoint identifier.",
            "schema": {
              "type": "string",
              "pattern": "^whe_[A-Za-z0-9_-]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "whe_7f8a9b0c1d234567890abcdef0123456"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "external_organisation_id"
                ],
                "properties": {
                  "external_organisation_id": {
                    "type": "string",
                    "x-axiom-identifier-classification": "opaque-resource-id",
                    "description": "The receiving organisation's identifier in the vendor's own\nsystem (for `xero_manual_journal`, the Xero organisation id\nthat Xero returns from its connections resource). It is the\nvendor's identifier, not an Axiom identity.\n",
                    "x-axiom-identifier-shape": "alpha-exception",
                    "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                  }
                }
              },
              "example": {
                "external_organisation_id": "<xero-organisation-id>"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The endpoint's connection.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "endpoint_id",
                            "carrier",
                            "external_organisation_id",
                            "credential_ref",
                            "created_at",
                            "updated_at"
                          ],
                          "properties": {
                            "endpoint_id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "carrier": {
                              "type": "string",
                              "enum": [
                                "xero_manual_journal"
                              ]
                            },
                            "external_organisation_id": {
                              "type": "string",
                              "x-axiom-identifier-classification": "opaque-resource-id",
                              "x-axiom-identifier-shape": "alpha-exception",
                              "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                            },
                            "credential_ref": {
                              "type": "string",
                              "x-axiom-identifier-classification": "connector-credential-path",
                              "description": "Server-derived OpenBao path reference to seed; never secret material."
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time"
                            },
                            "updated_at": {
                              "type": "string",
                              "format": "date-time"
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                },
                "example": {
                  "data": {
                    "endpoint_id": "whe_7f8a9b0c1d234567890abcdef0123456",
                    "carrier": "xero_manual_journal",
                    "external_organisation_id": "<xero-organisation-id>",
                    "credential_ref": "<tenant-id>/xero/<connection-id>",
                    "created_at": "2026-11-03T09:00:00Z",
                    "updated_at": "2026-11-03T09:00:00Z"
                  },
                  "status": "success"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/webhook-endpoints/{endpoint_id}/ledger-account-mappings": {
      "post": {
        "operationId": "addLedgerAccountMappings",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "webhook-delivery-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Append ledger account mappings for a webhook endpoint",
        "description": "Appends tenant-owned rows translating Axiom chart codes to the\nreceiver's account codes, effective-dated by journal business date\n(governed contract Rev 4). The mapping is append-only and bi-temporal:\nnothing is changed in place. A later `valid_from` takes over for later\ndates; a row with the same `valid_from` corrects that window (the\ndatabase stamps a later `recorded_at`). `external_account_code: null`\nis a tombstone that withdraws the mapping. A ledger carrier treats a\nmissing or withdrawn mapping as a terminal delivery failure, never a\ndefault account.\n\nA row that exactly repeats the row in force for its\n(`axiom_account_code`, `valid_from`) \u2014 same `external_account_code`\nand `valid_to` \u2014 is a no-op. The response is `201` when any row was\ninserted and `200` when none was. All rows are written in one\ntransaction.\n\n**Response format:** Canonical success envelope.\n",
        "tags": [
          "Webhook"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "endpoint_id",
            "in": "path",
            "required": true,
            "description": "Typed webhook-endpoint identifier.",
            "schema": {
              "type": "string",
              "pattern": "^whe_[A-Za-z0-9_-]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "whe_7f8a9b0c1d234567890abcdef0123456"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "mappings"
                ],
                "properties": {
                  "mappings": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 500,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "axiom_account_code",
                        "external_account_code",
                        "valid_from"
                      ],
                      "properties": {
                        "axiom_account_code": {
                          "type": "string",
                          "pattern": "^[A-Z][A-Z0-9_]*$",
                          "maxLength": 64
                        },
                        "external_account_code": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "minLength": 1,
                          "maxLength": 64,
                          "description": "Receiver account code; `null` withdraws the mapping."
                        },
                        "valid_from": {
                          "type": "string",
                          "format": "date"
                        },
                        "valid_to": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "date",
                          "description": "Exclusive end date; after valid_from when present."
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "mappings": [
                  {
                    "axiom_account_code": "INCOME_PREMIUM",
                    "external_account_code": "200",
                    "valid_from": "2026-11-01"
                  },
                  {
                    "axiom_account_code": "LIABILITY_CLAIMS_PAYABLE",
                    "external_account_code": "810",
                    "valid_from": "2026-11-01",
                    "valid_to": "2027-01-01"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Every row exactly repeated the row in force; nothing was inserted.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "endpoint_id",
                            "mappings"
                          ],
                          "properties": {
                            "endpoint_id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "mappings": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": false,
                                "required": [
                                  "axiom_account_code",
                                  "external_account_code",
                                  "valid_from",
                                  "valid_to",
                                  "recorded_at"
                                ],
                                "properties": {
                                  "axiom_account_code": {
                                    "type": "string"
                                  },
                                  "external_account_code": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "Receiver account code; `null` is a tombstone that withdraws the mapping."
                                  },
                                  "valid_from": {
                                    "type": "string",
                                    "format": "date"
                                  },
                                  "valid_to": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "format": "date"
                                  },
                                  "recorded_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "DB-owned transaction time. For one (axiom_account_code, valid_from) the row with the latest recorded_at is in force."
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "201": {
            "description": "At least one row was inserted; the rows in force for the requested keys.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "endpoint_id",
                            "mappings"
                          ],
                          "properties": {
                            "endpoint_id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "mappings": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": false,
                                "required": [
                                  "axiom_account_code",
                                  "external_account_code",
                                  "valid_from",
                                  "valid_to",
                                  "recorded_at"
                                ],
                                "properties": {
                                  "axiom_account_code": {
                                    "type": "string"
                                  },
                                  "external_account_code": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "Receiver account code; `null` is a tombstone that withdraws the mapping."
                                  },
                                  "valid_from": {
                                    "type": "string",
                                    "format": "date"
                                  },
                                  "valid_to": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "format": "date"
                                  },
                                  "recorded_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "DB-owned transaction time. For one (axiom_account_code, valid_from) the row with the latest recorded_at is in force."
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "listLedgerAccountMappings",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "webhook-delivery-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "List a webhook endpoint's ledger account mappings",
        "description": "Returns every mapping row of the endpoint, including corrected and\nwithdrawn history, ordered by `axiom_account_code`, `valid_from` and\n`recorded_at`.\n\n**Response format:** Canonical success envelope.\n",
        "tags": [
          "Webhook"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "endpoint_id",
            "in": "path",
            "required": true,
            "description": "Typed webhook-endpoint identifier.",
            "schema": {
              "type": "string",
              "pattern": "^whe_[A-Za-z0-9_-]+$",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "whe_7f8a9b0c1d234567890abcdef0123456"
          }
        ],
        "responses": {
          "200": {
            "description": "The endpoint's mapping rows with history.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "endpoint_id",
                            "mappings"
                          ],
                          "properties": {
                            "endpoint_id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "mappings": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "additionalProperties": false,
                                "required": [
                                  "axiom_account_code",
                                  "external_account_code",
                                  "valid_from",
                                  "valid_to",
                                  "recorded_at"
                                ],
                                "properties": {
                                  "axiom_account_code": {
                                    "type": "string"
                                  },
                                  "external_account_code": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "Receiver account code; `null` is a tombstone that withdraws the mapping."
                                  },
                                  "valid_from": {
                                    "type": "string",
                                    "format": "date"
                                  },
                                  "valid_to": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "format": "date"
                                  },
                                  "recorded_at": {
                                    "type": "string",
                                    "format": "date-time",
                                    "description": "DB-owned transaction time. For one (axiom_account_code, valid_from) the row with the latest recorded_at is in force."
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/outbox/webhook-deliveries/{delivery_id}": {
      "get": {
        "description": "Contract authority for GET /v1/mailroom/outbox/webhook-deliveries/{delivery_id} (getWebhookDeliveryStatus) in the Events/Assertions portfolio. This contract records semantic authority for the existing runtime-owned operation; runtime proof remains with the owning remediation finding.",
        "operationId": "getWebhookDeliveryStatus",
        "parameters": [
          {
            "description": "Path parameter `delivery_id`.",
            "in": "path",
            "name": "delivery_id",
            "required": true,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "webhook-delivery-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted \u2014 operation enqueued/applied per the envelope contract."
          },
          "400": {
            "description": "Validation error (fail-loud)."
          },
          "403": {
            "description": "Operating-tenant scope or permission denied."
          }
        },
        "security": [
          {
            "BearerAuth": [
              "mailroom:webhook:read"
            ]
          }
        ],
        "summary": "Get Webhook Delivery Status",
        "tags": [
          "Event"
        ],
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "webhook-delivery-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "bare",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "nonstandard",
          "scopes": [
            "mailroom:webhook:read"
          ],
          "required_permissions": [
            "mailroom:webhook:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ],
          "scope_exception": "One or more published scope names do not use the canonical resource:action form in API 0.2.126."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-nonread",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/mailroom/outbox/webhook-deliveries/{delivery_id}/redrive": {
      "post": {
        "operationId": "redriveWebhookDelivery",
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "webhook-delivery-execution",
        "x-axiom-configurability": "partial",
        "x-axiom-alpha-posture": "alpha",
        "summary": "Redrive a failed webhook delivery",
        "description": "Resets a `failed` delivery to `pending` on the same delivery record:\n`attempt_count` returns to 0, `next_retry_at` is now, and the last\nerror and `failed_at` are cleared. The event id, payload and endpoint\nare unchanged, so the receiver sees the same `oev_` id in\n`X-Axiom-Event-Id` and dedupes on it (governed contract).\n\nA delivery in any other status is a `409` `DELIVERY_NOT_FAILED`.\n\nFor a ledger carrier (`xero_manual_journal`), redrive is admitted only\nwhen the delivery's last error code proves nothing was posted:\n`ACCOUNT_MAPPING_MISSING`, `XERO_CONNECTION_MISSING`,\n`XERO_CREDENTIAL_REF_FOREIGN`, `CARRIER_UNAVAILABLE`,\n`EVENT_HAS_NO_JOURNAL`, `PAYLOAD_INVALID`, `XERO_TOKEN_PERSIST_FAILED`,\n`ENDPOINT_DISABLED`, `ENDPOINT_NOT_REGISTERED` or\n`XERO_VALIDATION_FAILED`. Any other code is a `409`\n`DELIVERY_OUTCOME_UNCONFIRMED`: redrive then needs a read-back from the\nreceiver showing no journal exists. `http_webhook` deliveries have no\nsuch restriction.\n\n**Response format:** Canonical success envelope.\n",
        "tags": [
          "Webhook"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "delivery_id",
            "in": "path",
            "required": true,
            "description": "Typed webhook delivery identifier.",
            "schema": {
              "type": "string",
              "pattern": "^whd_[A-Za-z0-9_-]+$",
              "x-axiom-identifier-classification": "webhook-delivery-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "example": "whd_8a9b0c1d2e345678901bcdef0123456"
          }
        ],
        "responses": {
          "200": {
            "description": "The reset delivery, now pending.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "delivery_id",
                            "endpoint_id",
                            "status",
                            "attempt_count",
                            "max_retries",
                            "correlation_id",
                            "created_at"
                          ],
                          "properties": {
                            "delivery_id": {
                              "type": "string",
                              "pattern": "^whd_[A-Za-z0-9_-]+$",
                              "x-axiom-identifier-classification": "webhook-delivery-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "endpoint_id": {
                              "type": "string",
                              "pattern": "^whe_[A-Za-z0-9_-]+$",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "pending",
                                "dispatched",
                                "delivered",
                                "failed"
                              ]
                            },
                            "attempt_count": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "max_retries": {
                              "type": "integer",
                              "minimum": 0
                            },
                            "next_retry_at": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "date-time"
                            },
                            "last_error_code": {
                              "type": "string"
                            },
                            "last_error_message_redacted": {
                              "type": "string"
                            },
                            "dispatched_at": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "date-time"
                            },
                            "delivered_at": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "date-time"
                            },
                            "failed_at": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "format": "date-time"
                            },
                            "correlation_id": {
                              "type": "string",
                              "x-axiom-identifier-classification": "correlation-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "intent_id": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time"
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                },
                "example": {
                  "data": {
                    "delivery_id": "whd_8a9b0c1d2e345678901bcdef0123456",
                    "endpoint_id": "whe_7f8a9b0c1d234567890abcdef0123456",
                    "status": "pending",
                    "attempt_count": 0,
                    "max_retries": 3,
                    "next_retry_at": "2026-11-03T09:00:00Z",
                    "dispatched_at": "2026-11-03T08:40:00Z",
                    "correlation_id": "corr_01HZXAMPLE000000000000000",
                    "created_at": "2026-11-03T08:39:59Z"
                  },
                  "status": "success"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/audit/recent": {
      "get": {
        "operationId": "getRecentAuditEntries",
        "summary": "Get recent audit entries",
        "description": "Returns recent audit log entries for the tenant, ordered by timestamp\ndescending (newest first).\n\nAudit entries record all significant actions: resource creation, updates,\ndeletions, state transitions, authentication events, and compliance checks.\n\nSupports filtering by subject type and cursor-based pagination. Legacy\nlimit/offset pagination is rejected; clients must use page[size] and\npage[after].\n",
        "tags": [
          "Audit"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Maximum number of audit entries to return in this cursor page (default 10, max 50)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 10
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as meta.next_cursor by the previous page",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subject_type",
            "in": "query",
            "required": false,
            "description": "Filter by subject type (e.g. policy, event, assertion, party, vendor, product).\nWhen omitted, returns entries for all subject types.\n",
            "schema": {
              "type": "string"
            },
            "example": "policy"
          }
        ],
        "responses": {
          "200": {
            "description": "List of recent audit entries",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AuditRecentListResponse"
                },
                "example": {
                  "data": [
                    {
                      "id": "aud_01arz3ndektsv4rrffq69g5fav",
                      "action": "state_transition",
                      "subject_type": "assertion",
                      "subject_id": "subject_ref_20260408_0001",
                      "actor": "assertion-assessor@tenant.example.com",
                      "details": {
                        "from_state": "open",
                        "to_state": "under_investigation",
                        "reason": "Assigned to motor assessor for vehicle inspection"
                      },
                      "correlation_id": "corr_20260408_0001",
                      "timestamp": "2026-03-12T14:22:00Z"
                    },
                    {
                      "id": "aud_01brz3ndektsv4rrffq69g5fav",
                      "action": "created",
                      "subject_type": "policy",
                      "subject_id": "subject_ref_20260408_0001",
                      "actor": "onboarding-service",
                      "details": {
                        "product_code": "motor-comprehensive",
                        "policy_number": "POL-US-2026-00142"
                      },
                      "timestamp": "2026-03-12T14:15:00Z"
                    }
                  ],
                  "status": "success",
                  "meta": {
                    "page_size": 10,
                    "has_more": true,
                    "next_cursor": "eyJwZXJmb3JtZWRfYXQiOiIyMDI2LTAzLTEyVDE0OjE1OjAwWiIsImlkIjoiYjBjMWQyZTMtZjRhNS02Nzg5LTAxMjMtNDU2Nzg5YWJjZGVmIn0"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "subject_type"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/extensions/schemas": {
      "post": {
        "operationId": "tenantRegisterSchema",
        "summary": "Register a new schema definition",
        "description": "Creates a new schema definition in draft state. The schema must pass\ncontent validation (valid JSON object, canonical field names under the governed contract)\nbefore it can be published.\n\nRequires actor attribution under the governed contract.\n",
        "tags": [
          "Tenant Schema",
          "Schema Registry"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "scope",
                  "entity_type",
                  "content",
                  "version",
                  "compatibility",
                  "actor_type",
                  "actor_id",
                  "actor_original_id"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Schema name (e.g. 'motor_vehicle')"
                  },
                  "scope": {
                    "type": "string",
                    "enum": [
                      "tenant"
                    ],
                    "description": "Tenant self-service schema scope"
                  },
                  "entity_type": {
                    "type": "string",
                    "enum": [
                      "party",
                      "party_role",
                      "party_contact",
                      "party_identity",
                      "party_relationship",
                      "party_group",
                      "party_group_membership",
                      "party_handling_classification",
                      "product",
                      "product_term",
                      "cover",
                      "cover_item",
                      "cover_term",
                      "cover_item_term",
                      "policy",
                      "policy_version",
                      "event",
                      "assertion",
                      "assertion_line"
                    ],
                    "description": "Target entity type"
                  },
                  "entity_sub_type": {
                    "type": "string",
                    "description": "Required for subtype-governed entity types. The schema name must be `<entity_type>.<entity_sub_type>`.\n"
                  },
                  "content": {
                    "type": "object",
                    "description": "Schema body as JSON object with canonical field names",
                    "additionalProperties": false
                  },
                  "version": {
                    "type": "object",
                    "required": [
                      "major",
                      "minor",
                      "patch"
                    ],
                    "properties": {
                      "major": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "minor": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "patch": {
                        "type": "integer",
                        "minimum": 0
                      }
                    },
                    "additionalProperties": false
                  },
                  "compatibility": {
                    "type": "string",
                    "enum": [
                      "backward",
                      "forward",
                      "breaking"
                    ],
                    "description": "Compatibility classification under the governed contract"
                  },
                  "predecessor_schema_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "description": "Extension schema typed-prefix identifier of the predecessor schema version for lineage tracking",
                    "example": "esd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "actor_type": {
                    "type": "string",
                    "enum": [
                      "human",
                      "service",
                      "agent"
                    ]
                  },
                  "actor_id": {
                    "type": "string",
                    "x-axiom-identifier-classification": "actor-id",
                    "x-axiom-identifier-shape": "opaque-string"
                  },
                  "actor_original_id": {
                    "type": "string",
                    "x-axiom-identifier-classification": "actor-original-id",
                    "x-axiom-identifier-shape": "opaque-string"
                  },
                  "deprecation_target_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Optional target date for future deprecation"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Schema registered successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SchemaDefinitionResponse-2"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (missing tenant, invalid JSON, invalid identifier)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Version conflict (duplicate semantic version)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error (invalid schema format, canonical field, compatibility, lineage)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      },
      "get": {
        "operationId": "tenantListSchemas",
        "summary": "List schema definitions with cursor pagination",
        "description": "Returns paginated schema definitions filtered by optional criteria.\nUses cursor-based pagination under the governed contract. Legacy limit/offset\npagination is rejected with 400.\n",
        "tags": [
          "Tenant Schema",
          "Schema Registry"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "page[size]",
            "in": "query",
            "required": false,
            "description": "Number of results per page (default 25, max 100)",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "required": false,
            "description": "Cursor token for next page (from previous response meta)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "description": "Filter by schema name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "description": "Filter by lifecycle state",
            "schema": {
              "type": "string",
              "enum": [
                "draft",
                "published",
                "deprecated"
              ]
            }
          },
          {
            "name": "scope",
            "in": "query",
            "required": false,
            "description": "Filter by scope",
            "schema": {
              "type": "string",
              "enum": [
                "tenant"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of schema definitions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/SchemaDefinition-2"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "page_size": {
                          "type": "integer"
                        },
                        "next_page_token": {
                          "type": "string",
                          "description": "Cursor containing the typed-prefix schema identifier returned by this endpoint."
                        }
                      },
                      "additionalProperties": false
                    },
                    "status": {
                      "type": "string",
                      "x-axiom-coded-value-classification": "tenant-lifecycle-status"
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (missing tenant, limit/offset rejected)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "name",
            "state",
            "scope"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/extensions/schemas/resolve": {
      "get": {
        "operationId": "tenantResolveSchema",
        "summary": "Resolve a schema by name and semantic version",
        "description": "Looks up a specific schema definition by name and exact semantic\nversion triplet. Returns 404 with SCHEMA_NOT_FOUND if no match exists.\n",
        "tags": [
          "Tenant Schema",
          "Schema Registry"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "name",
            "in": "query",
            "required": true,
            "description": "Schema name to resolve",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "query",
            "required": true,
            "description": "Semantic version in major.minor.patch format",
            "schema": {
              "type": "string",
              "example": "1.0.0"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Schema resolved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SchemaDefinitionResponse-2"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid query parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Schema not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "name",
            "version"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/extensions/schemas/{schema_id}": {
      "get": {
        "operationId": "tenantGetSchema",
        "summary": "Get a schema definition by ID",
        "description": "Retrieves a single schema definition by its typed-prefix schema identifier.\nScoped to the tenant from the request context.\n",
        "tags": [
          "Tenant Schema",
          "Schema Registry"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "schema_id",
            "in": "path",
            "required": true,
            "description": "Extension schema typed-prefix identifier",
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^esd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "esd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "extension-schema-definition-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "esd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
          }
        ],
        "responses": {
          "200": {
            "description": "Schema definition",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SchemaDefinitionResponse-2"
                }
              }
            }
          },
          "400": {
            "description": "Invalid schema identifier",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "Schema not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/extensions/schemas/{schema_id}/publish": {
      "post": {
        "operationId": "tenantPublishSchema",
        "summary": "Publish a draft schema",
        "description": "Transitions a schema from draft to published state. Requires\nexpected_version for optimistic concurrency control.\n\nBefore publication, validates:\n- Schema content (JSON object, canonical field names)\n- Compatibility classification\n- Platform schema compatibility (for tenant-scoped schemas)\n\nPublished schemas are immutable \u2014 content, version, and compatibility\ncannot be changed after publication under the governed contract.\n",
        "tags": [
          "Tenant Schema",
          "Schema Registry"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "schema_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^esd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "esd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "extension-schema-definition-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "esd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "expected_version",
                  "actor_type",
                  "actor_id",
                  "actor_original_id"
                ],
                "properties": {
                  "expected_version": {
                    "type": "integer",
                    "description": "Current version for optimistic locking"
                  },
                  "actor_type": {
                    "type": "string",
                    "enum": [
                      "human",
                      "service",
                      "agent"
                    ]
                  },
                  "actor_id": {
                    "type": "string",
                    "x-axiom-identifier-classification": "actor-id",
                    "x-axiom-identifier-shape": "opaque-string"
                  },
                  "actor_original_id": {
                    "type": "string",
                    "x-axiom-identifier-classification": "actor-original-id",
                    "x-axiom-identifier-shape": "opaque-string"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Schema published successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SchemaDefinitionResponse-2"
                }
              }
            }
          },
          "409": {
            "description": "Version conflict or schema already published/deprecated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error (invalid content, compatibility, or platform schema)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/extensions/schemas/{schema_id}/deprecate": {
      "post": {
        "operationId": "tenantDeprecateSchema",
        "summary": "Deprecate a published schema",
        "description": "Transitions a schema from published to deprecated state. Requires\na reason and expected_version for optimistic concurrency control.\n\nDeprecation is idempotent \u2014 deprecating an already-deprecated schema\nreturns success with the current state.\n\nDeprecated schemas remain queryable but are marked as superseded.\nPublished records are never deleted or mutated under the governed contract.\n",
        "tags": [
          "Tenant Schema",
          "Schema Registry"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationId"
          },
          {
            "name": "schema_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^esd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "esd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "extension-schema-definition-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "example": "esd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "expected_version",
                  "reason",
                  "actor_type",
                  "actor_id",
                  "actor_original_id"
                ],
                "properties": {
                  "expected_version": {
                    "type": "integer",
                    "description": "Current version for optimistic locking"
                  },
                  "reason": {
                    "type": "string",
                    "description": "Reason for deprecation"
                  },
                  "actor_type": {
                    "type": "string",
                    "enum": [
                      "human",
                      "service",
                      "agent"
                    ]
                  },
                  "actor_id": {
                    "type": "string",
                    "x-axiom-identifier-classification": "actor-id",
                    "x-axiom-identifier-shape": "opaque-string"
                  },
                  "actor_original_id": {
                    "type": "string",
                    "x-axiom-identifier-classification": "actor-original-id",
                    "x-axiom-identifier-shape": "opaque-string"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Schema deprecated successfully (or already deprecated)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SchemaDefinitionResponse-2"
                }
              }
            }
          },
          "409": {
            "description": "Version conflict or schema not in published state",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Missing reason",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/roles/{roleId}": {
      "delete": {
        "operationId": "revokePartyRole",
        "summary": "Revoke a party role",
        "description": "Revoke an active role assignment from a Party. The role assignment remains\npart of the Party history and audit record; this operation changes its\nactive status rather than deleting historical evidence.\n",
        "tags": [
          "Party"
        ],
        "security": [
          {
            "BearerAuth": [
              "parties:revoke-role"
            ]
          }
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "roleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id"
            },
            "description": "Party role assignment identifier to revoke."
          }
        ],
        "responses": {
          "200": {
            "description": "Party role revoked successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyRoleRevocationResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "parties:revoke-role"
          ],
          "required_permissions": [
            "parties:revoke-role"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/parties/{id}/balance": {
      "get": {
        "operationId": "getPartyBalance",
        "summary": "Get a party balance",
        "description": "Return the ledger-derived balance for a Party, optionally scoped by\nproduct, policy, cover, category, role, and as-of time. The response is\ncomputed from runtime ledger entries and is read-only.\n",
        "tags": [
          "Party"
        ],
        "parameters": [
          {
            "name": "X-Tenant-Context",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)"
          },
          {
            "name": "X-Correlation-ID",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            },
            "description": "Request correlation ID for tracing"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Unique party identifier"
          },
          {
            "name": "product_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "prd_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "product-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Limit the balance to entries associated with this product."
          },
          {
            "name": "policy_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
              "example": "pol_01arz3ndektsv4rrffq69g5fav",
              "x-axiom-identifier-classification": "policy-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Limit the balance to entries associated with this policy."
          },
          {
            "name": "cover_id",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "typed-prefix-id",
              "x-axiom-identifier-shape": "typed-prefix"
            },
            "description": "Limit the balance to entries associated with this cover."
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Limit the balance to a ledger category."
          },
          {
            "name": "role",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Limit the balance to a tenant `catalogue.role_types` code."
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Compute the balance as of this RFC3339 timestamp. Defaults to the current instant."
          },
          {
            "name": "decompose",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Include balance computation explanation details when true."
          }
        ],
        "responses": {
          "200": {
            "description": "Party balance retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PartyBalanceResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "product_id",
            "policy_id",
            "cover_id",
            "category",
            "role",
            "decompose"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/premiums/{id}/collect": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "description": "Premium identifier. Accepts the canonical `prm_...` typed-prefix form or a UUID.",
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "prm_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "premium-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "post": {
        "operationId": "postPremiumsIdCollect",
        "tags": [
          "Premium"
        ],
        "summary": "Collect a premium payment",
        "description": "Record a collected premium payment as a balanced ledger transaction with one debit entry and one or more per-allocation credit entries. The request is idempotent by business event: replay returns the original transaction with `is_replay=true` and no duplicate ledger entries.\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/vnd.api+json": {
              "schema": {
                "type": "object",
                "required": [
                  "data"
                ],
                "properties": {
                  "data": {
                    "type": "object",
                    "required": [
                      "type",
                      "attributes"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "premium-collections"
                        ]
                      },
                      "attributes": {
                        "type": "object",
                        "required": [
                          "payment_id"
                        ],
                        "properties": {
                          "payment_id": {
                            "type": "string",
                            "description": "Payment identifier for the collection event.",
                            "example": "pay_01h9xg2c7e8f4a5b6c7d8e9f0a",
                            "x-axiom-identifier-classification": "payment-id",
                            "x-axiom-identifier-shape": "opaque-string"
                          },
                          "collected_at": {
                            "type": "string",
                            "format": "date-time",
                            "description": "Business timestamp for the collection. Omitted means the API records the current time.",
                            "example": "2026-04-01T10:00:00Z"
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              "examples": {
                "collect": {
                  "summary": "Collected premium payment",
                  "value": {
                    "data": {
                      "type": "premium-collections",
                      "attributes": {
                        "payment_id": "pay_01h9xg2c7e8f4a5b6c7d8e9f0a",
                        "collected_at": "2026-04-01T10:00:00Z"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Idempotent replay of an already-posted collection.",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "status"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "required": [
                        "type",
                        "id",
                        "attributes"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "premium-collections"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "prm_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "premium-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "attributes": {
                          "type": "object",
                          "required": [
                            "transaction_id",
                            "is_replay",
                            "debit_entry",
                            "credit_entries"
                          ],
                          "properties": {
                            "transaction_id": {
                              "type": "string",
                              "x-axiom-identifier-classification": "ledger-transaction-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "is_replay": {
                              "type": "boolean",
                              "enum": [
                                true
                              ]
                            },
                            "debit_entry": {
                              "$ref": "#/components/schemas/PremiumCollectionLedgerEntry"
                            },
                            "credit_entries": {
                              "type": "array",
                              "items": {
                                "$ref": "#/components/schemas/PremiumCollectionLedgerEntry"
                              }
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "success"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "201": {
            "description": "Premium collection posted.",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "status"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "required": [
                        "type",
                        "id",
                        "attributes"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "premium-collections"
                          ]
                        },
                        "id": {
                          "type": "string",
                          "description": "Ledger transaction identifier.",
                          "format": "typed-prefix-id",
                          "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "prm_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "premium-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "attributes": {
                          "type": "object",
                          "required": [
                            "transaction_id",
                            "is_replay",
                            "debit_entry",
                            "credit_entries"
                          ],
                          "properties": {
                            "transaction_id": {
                              "type": "string",
                              "x-axiom-identifier-classification": "ledger-transaction-id",
                              "x-axiom-identifier-shape": "opaque-string"
                            },
                            "is_replay": {
                              "type": "boolean"
                            },
                            "debit_entry": {
                              "$ref": "#/components/schemas/PremiumCollectionLedgerEntry"
                            },
                            "credit_entries": {
                              "type": "array",
                              "items": {
                                "$ref": "#/components/schemas/PremiumCollectionLedgerEntry"
                              }
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "success"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/cover-balances/claims-ratio": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "description": "Resource identifier.",
          "schema": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "getPolicyCoverClaimsRatio",
        "tags": [
          "Policy"
        ],
        "x-axiom-runtime-availability": {
          "status": "unavailable",
          "reason": "Runtime retains the canonical quarantine501Handler under the approved disposition. Restoration requires a financial definition approved through the applicable ADR/Council process.",
          "source": "runtime source"
        },
        "summary": "Cover claims-ratio unavailable pending financial definition",
        "description": "This route is intentionally unavailable in alpha. It remains present for route accountability as a retained public compatibility identifier, but the cover-balance and availability operations remain separate reads. Restoration of this ratio requires an approved numerator, denominator, matching scope, currency, correction rules, zero-denominator behavior and constituent provenance through the applicable ADR/Council process.\n",
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "501": {
            "description": "Claims-ratio aggregation remains unavailable pending an approved financial definition.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "limited",
          "published": true,
          "authorisation": "not-callable-until-runtime-support-lands",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Published for route accountability in API 0.2.126; this operation returns 501 until runtime support lands."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "missing-contract-gap",
          "tenant_context_authority": "not-required",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication"
          ],
          "tenant_context_exception": "This authenticated operation does not publish an X-Tenant-Context header contract in API 0.2.126. Treat tenant-context handling as an explicit contract gap until the operation is deepened."
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "not-safe-gap",
          "tenant_context": "missing-contract-gap",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/policies/{id}/audit": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "description": "Canonical typed policy identifier (pol_ prefix).",
          "schema": {
            "type": "string",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "format": "typed-prefix-id",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "getPoliciesIdAudit",
        "tags": [
          "Policy"
        ],
        "summary": "Read the policy audit trail",
        "description": "Audit rows for an existing policy in the operating tenant. A missing entity returns 404; storage failures remain server errors. Continuations bind the operating tenant and entity and use performed_at DESC plus immutable row ID ASC. Malformed, legacy offset or rebound cursors return 400; restart traversal after upgrading. The feed is a live read, not a transaction-consistent historical export.\n",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "page[size]",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful tenant-scoped read.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntityAuditListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/claims/{id}/audit": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "description": "Canonical typed assertion identifier (clm_ compatibility prefix).",
          "schema": {
            "type": "string",
            "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
            "format": "typed-prefix-id",
            "example": "clm_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "claim-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "getClaimsIdAudit",
        "deprecated": true,
        "x-axiom-substrate-kind": "execution",
        "x-axiom-substrate-id": "events-assertions-compatibility-lifecycle",
        "x-axiom-configurability": "none",
        "x-axiom-alpha-posture": "alpha",
        "tags": [
          "Claim"
        ],
        "summary": "Get retained claim-family audit trail",
        "description": "Returns the tenant-scoped audit trail for the retained claim-family compatibility resource after verifying that it exists for the operating tenant.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "page[size]",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "description": "Resource-bound keyset cursor; old offset cursors return 400 and require traversal restart.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Retained claim-family audit entries retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntityAuditListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "x-axiom-workflow-contract": "docs/product/events-assertions-compatibility-lifecycle-contract.md",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/rulesets/{id}/audit": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "description": "Canonical typed ruleset identifier (rst_ prefix).",
          "schema": {
            "type": "string",
            "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
            "format": "typed-prefix-id",
            "example": "rst_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "ruleset-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      ],
      "get": {
        "operationId": "getRulesetsIdAudit",
        "tags": [
          "Rulesets"
        ],
        "summary": "Read the ruleset audit trail",
        "description": "Audit rows for an existing ruleset in the operating tenant. A missing entity returns 404; storage failures remain server errors. Continuations bind the operating tenant and entity and use performed_at DESC plus immutable row ID ASC. Malformed, legacy offset or rebound cursors return 400; restart traversal after upgrading. The feed is a live read, not a transaction-consistent historical export.\n",
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "name": "page[size]",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "page[after]",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful tenant-scoped read.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntityAuditListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "cursor",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "cursor",
          "request_parameters": [
            "page[size]",
            "page[after]"
          ],
          "consumer_posture": "cursor-page",
          "response_metadata": [
            "meta.next_cursor",
            "meta.page_size"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/accounts/{account_id}/grants": {
      "post": {
        "description": "Issue an evidenced finite tenant_user grant for an existing active human Account in the operating tenant. Permission-qualified tenant automation may issue it. Exact repeats preserve expiry; creation cannot renew or reactivate a terminated grant. No Party or membership is created.",
        "operationId": "createAccountGrant",
        "parameters": [
          {
            "description": "Account id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "act_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "account_id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^act_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountGrantRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountGrantResponse"
                }
              }
            },
            "description": "Identical active grant confirmed without extending expiry."
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountGrantResponse"
                }
              }
            },
            "description": "Tenant access grant created with audit reference."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "accounts:grant-tenant-user"
            ]
          }
        ],
        "summary": "Issue Tenant Access Grant",
        "tags": [
          "Party",
          "identity",
          "access"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "accounts:grant-tenant-user"
          ],
          "required_permissions": [
            "accounts:grant-tenant-user"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/accounts/{account_id}/party-links": {
      "post": {
        "description": "Create an audited initial identity association. A live tenant IAM actor and evidence reference are required. The Account must be a separate active human in the same tenant. Exact repeats are idempotent; conflicting links are rejected. No business grants, Parties or memberships are created.",
        "operationId": "createAccountPartyLink",
        "parameters": [
          {
            "description": "Account id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "act_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "account_id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^act_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountPartyLinkRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountPartyLinkResponse"
                }
              }
            },
            "description": "Existing identical association confirmed without a second audit event."
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountPartyLinkResponse"
                }
              }
            },
            "description": "Initial association created; audit_id is returned on creation."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "accounts:link-party"
            ]
          }
        ],
        "summary": "Link Account to Existing Party",
        "tags": [
          "Party",
          "identity",
          "access"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "accounts:link-party"
          ],
          "required_permissions": [
            "accounts:link-party"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/me/party-groups": {
      "get": {
        "description": "Read the current authenticated Account linked Party family-anchor summary. A live parties.read grant and current family-anchor relationship are both required. No selectors, contacts, identity attributes, admission conclusions or financial/clinical data are returned. Tenant-user calls to unqualified adjacent APIs are denied.",
        "operationId": "getMyPartyGroups",
        "parameters": [
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OwnFamilySummaryResponse"
                }
              }
            },
            "description": "Current authorised family summary."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "parties:read"
            ]
          }
        ],
        "summary": "Read Own Family Summary",
        "tags": [
          "Party",
          "identity",
          "access"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "parties:read"
          ],
          "required_permissions": [
            "parties:read"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/party-groups/{id}/family-anchor-assignments": {
      "post": {
        "description": "Assign an existing active Party membership as the family anchor using tenant IAM authority and an evidence reference. Preserve the membership world interval, close the prior assertion and append a new assertion. Exact repeats are idempotent; competing anchors conflict. No new family or commercial membership is created.",
        "operationId": "assignFamilyAnchor",
        "parameters": [
          {
            "description": "PartyGroup id in canonical typed-prefix form (governed contract 3.2). A bare UUID is rejected rather than resolved.",
            "example": "pgr_01abcdefghjkmnpqrstvwxyz01",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "format": "typed-prefix-id",
              "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
              "type": "string",
              "x-axiom-identifier-shape": "typed-prefix"
            }
          },
          {
            "description": "Operating-tenant context (binding: operating_tenant).",
            "in": "header",
            "name": "X-Tenant-Context",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Request correlation ID (governed contract). Generated by the server if omitted; always echoed in the response.",
            "in": "header",
            "name": "X-Correlation-ID",
            "required": false,
            "schema": {
              "type": "string",
              "x-axiom-identifier-classification": "correlation-id",
              "x-axiom-identifier-shape": "opaque-string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FamilyAnchorAssignmentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FamilyAnchorAssignmentResponse"
                }
              }
            },
            "description": "Existing membership anchor assigned or identical assignment confirmed."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "BearerAuth": [
              "parties:assign-family-anchor"
            ]
          }
        ],
        "summary": "Assign Existing Family Anchor",
        "tags": [
          "Party",
          "identity",
          "access"
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "endpoint-specific",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "endpoint-specific",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "standard",
          "scopes": [
            "parties:assign-family-anchor"
          ],
          "required_permissions": [
            "parties:assign-family-anchor"
          ],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation",
            "scope-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/me/tenants": {
      "get": {
        "operationId": "getMeTenants",
        "tags": [
          "Identity"
        ],
        "summary": "List admitted tenants",
        "description": "Returns the tenants admitted for the authenticated actor. Use the returned tenant selection data to request a server-minted tenant context.",
        "responses": {
          "200": {
            "description": "Admitted tenant list for the authenticated actor.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data",
                        "status"
                      ],
                      "properties": {
                        "data": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "required": [
                              "id",
                              "name",
                              "granting_role"
                            ],
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "typed-prefix-id",
                                "pattern": "^tnt_[0-9a-hjkmnp-tv-z]{26}$",
                                "description": "Tenant identifier admitted for this authenticated actor.",
                                "example": "tnt_01arz3ndektsv4rrffq69g5fav",
                                "x-axiom-identifier-shape": "typed-prefix"
                              },
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255,
                                "description": "Tenant display name.",
                                "example": "Example Tenant"
                              },
                              "granting_role": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128,
                                "description": "Role granting access to the tenant.",
                                "example": "tenant_operator"
                              }
                            }
                          }
                        },
                        "meta": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "description": "Number of admitted tenants returned."
                            },
                            "has_more": {
                              "type": "boolean",
                              "description": "Whether another tenant page exists after this one."
                            },
                            "next_cursor": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "Opaque cursor for the next tenant admission page, when present."
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Bearer token missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "No tenant admission is available for this actor.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "bootstrap-not-required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "admitted-tenant-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "bootstrap-read",
          "tenant_context": "bootstrap-not-required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/me/tenant-context": {
      "post": {
        "operationId": "postMeTenantContext",
        "tags": [
          "Identity"
        ],
        "summary": "Mint tenant context",
        "description": "Mints a server-authoritative tenant-context token for one admitted tenant. Use that token as the X-Tenant-Context header on tenant-scoped API calls.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "tenant_id"
                ],
                "properties": {
                  "tenant_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "pattern": "^tnt_[0-9a-hjkmnp-tv-z]{26}$",
                    "description": "Tenant identifier selected from GET /v1/me/tenants.",
                    "example": "tnt_01arz3ndektsv4rrffq69g5fav",
                    "x-axiom-identifier-shape": "typed-prefix"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tenant context minted for an admitted tenant.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SuccessEnvelope"
                    },
                    {
                      "type": "object",
                      "required": [
                        "data",
                        "status"
                      ],
                      "properties": {
                        "data": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "tenant_context_token",
                            "tenant_id",
                            "expires_at"
                          ],
                          "properties": {
                            "tenant_context_token": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Server-minted token for X-Tenant-Context on tenant-scoped requests.",
                              "example": "<server-minted tenant-context token>"
                            },
                            "tenant_id": {
                              "type": "string",
                              "format": "typed-prefix-id",
                              "pattern": "^tnt_[0-9a-hjkmnp-tv-z]{26}$",
                              "description": "Tenant identifier bound into the token.",
                              "example": "tnt_01arz3ndektsv4rrffq69g5fav",
                              "x-axiom-identifier-shape": "typed-prefix"
                            },
                            "expires_at": {
                              "type": "string",
                              "format": "date-time",
                              "description": "UTC expiry timestamp.",
                              "example": "2026-08-10T12:00:00Z"
                            }
                          }
                        }
                      },
                      "additionalProperties": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Tenant selection payload is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Bearer token missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The selected tenant is not admitted for this actor.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "legacy-envelope",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "legacy-envelope",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "bootstrap-not-required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "admitted-tenant-authorisation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "bootstrap-mint-restricted",
          "tenant_context": "bootstrap-not-required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms": {
      "get": {
        "operationId": "listWorkrooms",
        "summary": "List visible Workrooms",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          },
          {
            "name": "include_hidden",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "include_left",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Workrooms returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomVisibilityDenied"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "explicit-filters"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "explicit-filters",
          "filter_parameters": [
            "include_hidden",
            "include_left"
          ]
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms/default": {
      "post": {
        "operationId": "ensureDefaultWorkroom",
        "summary": "Ensure the tenant-local General Workroom",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey-2"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "responses": {
          "200": {
            "description": "General Workroom ensured.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "409": {
            "$ref": "#/components/responses/IdempotencyConflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms/last-active": {
      "get": {
        "operationId": "getLastActiveWorkroom",
        "summary": "Get the identity-scoped last active Workroom",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "responses": {
          "200": {
            "description": "Last active Workroom returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomVisibilityDenied"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "put": {
        "operationId": "setLastActiveWorkroom",
        "summary": "Set the identity-scoped last active Workroom",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey-2"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetLastActiveWorkroomRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Last active Workroom updated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomVisibilityDenied"
          },
          "404": {
            "$ref": "#/components/responses/WorkroomNotFound"
          },
          "409": {
            "$ref": "#/components/responses/IdempotencyConflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms/{workroom_id}/hidden": {
      "put": {
        "operationId": "setWorkroomHidden",
        "summary": "Set per-identity hidden state for a Workroom",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/WorkroomId"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey-2"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWorkroomHiddenRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Hidden state updated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomVisibilityDenied"
          },
          "404": {
            "$ref": "#/components/responses/WorkroomNotFound"
          },
          "409": {
            "$ref": "#/components/responses/GeneralWorkroomImmutable"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms/{workroom_id}/members": {
      "get": {
        "operationId": "listWorkroomMembers",
        "summary": "List Workroom members",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/WorkroomId"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "responses": {
          "200": {
            "description": "Workroom members returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomMemberListResponse"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomPermissionDenied"
          },
          "404": {
            "$ref": "#/components/responses/WorkroomNotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "bounded-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "bounded-list",
          "request_parameters": [],
          "consumer_posture": "explicit-bounded-list",
          "exception": "This list is intentionally published as an API 0.2.126 bounded-list exception with no page traversal contract. Consumers must not infer cursor, offset, or full-history traversal semantics from this operation.",
          "response_metadata": [
            "meta.total"
          ]
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": false,
          "read_allowed": true,
          "write_allowed": false,
          "agent_invocation": "safe-read",
          "tenant_context": "required",
          "idempotency_required": false,
          "retry_automation": "safe-read-policy-required",
          "source": "generated-public-openapi-profile"
        }
      },
      "post": {
        "operationId": "addWorkroomMember",
        "summary": "Add or invite a Workroom member",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/WorkroomId"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey-2"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkroomMemberMutationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Workroom member added.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomMemberResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomPermissionDenied"
          },
          "404": {
            "$ref": "#/components/responses/WorkroomNotFound"
          },
          "409": {
            "$ref": "#/components/responses/IdempotencyConflict"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms/{workroom_id}/members/{identity_id}/role": {
      "put": {
        "operationId": "changeWorkroomMemberRole",
        "summary": "Change a Workroom member role",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/WorkroomId"
          },
          {
            "$ref": "#/components/parameters/IdentityId"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey-2"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkroomMemberMutationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Workroom member role changed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomMemberResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomPermissionDenied"
          },
          "404": {
            "$ref": "#/components/responses/WorkroomNotFound"
          },
          "409": {
            "$ref": "#/components/responses/LastOwnerRequired"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms/{workroom_id}/members/{identity_id}": {
      "delete": {
        "operationId": "removeWorkroomMember",
        "summary": "Remove a Workroom member",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/WorkroomId"
          },
          {
            "$ref": "#/components/parameters/IdentityId"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey-2"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "responses": {
          "204": {
            "description": "Workroom member removed."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomPermissionDenied"
          },
          "404": {
            "$ref": "#/components/responses/WorkroomNotFound"
          },
          "409": {
            "$ref": "#/components/responses/LastOwnerRequired"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "bare",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "bare",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    },
    "/v1/workrooms/{workroom_id}/leave": {
      "post": {
        "operationId": "leaveWorkroom",
        "summary": "Leave a non-General Workroom",
        "tags": [
          "Workroom"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TenantIdHeader"
          },
          {
            "$ref": "#/components/parameters/WorkroomId"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey-2"
          },
          {
            "$ref": "#/components/parameters/CorrelationHeader-2"
          }
        ],
        "responses": {
          "200": {
            "description": "Workroom left.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkroomResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WorkroomVisibilityDenied"
          },
          "404": {
            "$ref": "#/components/responses/WorkroomNotFound"
          },
          "409": {
            "$ref": "#/components/responses/GeneralWorkroomImmutable"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "x-axiom-public-maturity": {
          "availability": "developer-preview",
          "stability": "evolving",
          "response_profile": "json-api",
          "usage": "available",
          "published": true,
          "authorisation": "requires-issued-alpha-access-pack",
          "alpha_access_required": true,
          "production_ready": false,
          "note": "Available to admitted alpha consumers when their issued access pack grants authority; breaking changes remain possible before 1.0.0."
        },
        "x-axiom-contract-consistency": {
          "response_profile": "json-api",
          "error_profile": "json-api",
          "pagination_profile": "not-list",
          "filter_profile": "none"
        },
        "x-axiom-pagination-contract": {
          "profile": "not-list",
          "request_parameters": [],
          "consumer_posture": "not-list"
        },
        "x-axiom-filter-contract": {
          "profile": "none",
          "filter_parameters": []
        },
        "x-axiom-auth-contract": {
          "bearer": "required",
          "scope_profile": "none",
          "scopes": [],
          "required_permissions": [],
          "permission_runtime_posture": "alpha-posture",
          "tenant_context": "required",
          "tenant_context_authority": "server-minted-X-Tenant-Context",
          "client_supplied_tenant_id_authority": "forbidden",
          "failure_order": [
            "bearer-authentication",
            "tenant-context-validation"
          ]
        },
        "x-axiom-operational-limits": {
          "upload": {
            "mode": "not-upload"
          },
          "rate_limit": {
            "posture": "not-published",
            "exception": "API 0.2.126 does not publish a per-operation rate-limit commitment."
          }
        },
        "x-axiom-operation-safety": {
          "mutation": true,
          "read_allowed": false,
          "write_allowed": false,
          "agent_invocation": "restricted-mutation",
          "tenant_context": "required",
          "idempotency_required": true,
          "retry_automation": "forbidden-for-mutation",
          "source": "generated-public-openapi-profile"
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "JWT token obtained from authentication service"
      },
      "CarrierReceiptSignature": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Hub-Signature-256",
        "description": "Carrier provider request signature for carrier receipt deliveries. Not a static key: the header value is `sha256=` followed by the 64-character hex HMAC-SHA256 of the exact raw request body, computed by the carrier provider with the app secret registered in the tenant carrier configuration addressed by the path receiver key. The secret itself is never sent. The signature is verified in constant time before the body is parsed or stored; a missing, malformed or mismatched signature is refused with 403 `CARRIER_RECEIPT_REFUSED`. A per-receiver-key rate limit is checked before the signature is verified and returns 429. No bearer token or tenant context is used on this route."
      },
      "CarrierReceiptVerifyToken": {
        "type": "apiKey",
        "in": "query",
        "name": "hub.verify_token",
        "description": "Carrier provider subscription-handshake token for carrier receipt subscriptions. Send `hub.mode=subscribe`, `hub.challenge` and the verify token registered in the tenant carrier configuration addressed by the path receiver key. The token is compared in constant time; a missing or mismatched token, or any other mode, is refused with 403 `CARRIER_RECEIPT_REFUSED`. A per-receiver-key rate limit is checked before the token is compared and returns 429. No bearer token or tenant context is used on this route."
      }
    },
    "parameters": {
      "CarrierConfigID": {
        "in": "path",
        "name": "carrier_config_id",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^ccf_",
          "x-axiom-identifier-shape": "typed-prefix"
        },
        "description": "Typed `ccf_` carrier configuration id."
      },
      "CatalogueRefPath": {
        "name": "catalogue-ref",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "Logical catalogue identifier (slug, e.g. `icd-10-za`)."
      },
      "CatalogueRelationshipRefPath": {
        "name": "catalogue-ref",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "Logical catalogue identifier (e.g. `icd-10-za`)."
      },
      "CorrelationHeader": {
        "name": "X-Correlation-ID",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "x-axiom-identifier-classification": "correlation-id",
          "x-axiom-identifier-shape": "opaque-string"
        },
        "description": "Correlation id for request tracing."
      },
      "CorrelationHeader-2": {
        "name": "X-Correlation-ID",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "x-axiom-identifier-classification": "correlation-id",
          "x-axiom-identifier-shape": "opaque-string"
        }
      },
      "CorrelationId": {
        "name": "X-Correlation-ID",
        "in": "header",
        "required": false,
        "description": "Request correlation ID for end-to-end tracing.\nIf not provided, the server generates one automatically.\nThe response always includes this header for support reference.\n",
        "schema": {
          "type": "string",
          "x-axiom-identifier-classification": "correlation-id",
          "x-axiom-identifier-shape": "opaque-string"
        },
        "example": "req-abc-123-def-456"
      },
      "IdempotencyKey": {
        "name": "Idempotency-Key",
        "in": "header",
        "required": true,
        "description": "Client-supplied idempotency key for replay-safe mutation requests.\n\nThe server scopes the key to the tenant, HTTP method, and matched path.\nA replay with the same key and same payload returns the original response.\nA replay with the same key and a different payload returns `409 CONFLICT`.\nA concurrent replay while the first request is still in flight returns\n`409 CONFLICT` with `Retry-After`.\n",
        "schema": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256
        },
        "example": "idem-payment-20260821-001"
      },
      "IdempotencyKey-2": {
        "name": "Idempotency-Key",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "minLength": 1
        }
      },
      "IdentityId": {
        "name": "identity_id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "x-axiom-identifier-classification": "opaque-resource-id",
          "x-axiom-identifier-shape": "alpha-exception",
          "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
        }
      },
      "LogicalEntryIdPath": {
        "name": "logical_entry_id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "x-axiom-identifier-classification": "catalogue-logical-entry-id",
          "x-axiom-identifier-shape": "opaque-string"
        },
        "description": "Typed-prefix `cei_` logical-entry grouping ID. This is the stable cross-version identity\nfor the same logical code over time. Assigned by the server on first\ncreateBiTemporalEntry call (when caller omits logical_entry_id) or\nsupplied by the caller to pin a new bi-temporal version to an existing\nlogical entry.\n"
      },
      "PageAfter-2": {
        "name": "page[after]",
        "in": "query",
        "required": false,
        "description": "Opaque cursor returned as meta.next_cursor by the previous page.",
        "schema": {
          "type": "string"
        }
      },
      "PageSize-2": {
        "name": "page[size]",
        "in": "query",
        "required": false,
        "description": "Maximum support requests to return (default 50, max 200).",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200,
          "default": 50
        }
      },
      "ReplacementIdPath": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "format": "typed-prefix-id",
          "x-axiom-identifier-shape": "typed-prefix"
        },
        "description": "Replacement workflow identifier (prp_ typed-prefix).",
        "example": "prp_01j1234567890abcdefghijk"
      },
      "SupportRequestCorrelationHeader": {
        "name": "X-Correlation-ID",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "x-axiom-identifier-classification": "correlation-id",
          "x-axiom-identifier-shape": "opaque-string"
        },
        "description": "Correlation id for request tracing."
      },
      "SupportRequestId": {
        "name": "request_id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "pattern": "^crq_[0-9a-f-]{36}$",
          "x-axiom-identifier-classification": "request-id",
          "x-axiom-identifier-shape": "opaque-string"
        },
        "description": "Canonical collaboration_request identifier."
      },
      "SupportRequestIdempotencyKey": {
        "name": "Idempotency-Key",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "minLength": 1
        },
        "description": "Required for support request mutations."
      },
      "TenantHeader": {
        "name": "X-Tenant-Context",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "Tenant-context token (TCT) from POST /v1/me/tenant-context (governed contract)."
      },
      "TenantIdHeader": {
        "name": "X-Tenant-Context",
        "in": "header",
        "required": true,
        "description": "Server-minted tenant-context token (TCT) in request header.\n\n**Required** for all tenant-scoped requests. Obtain it from\n`POST /v1/me/tenant-context` after discovering accessible tenants via\n`GET /v1/me/tenants`. The TCT is a short-lived HMAC-signed token that\ncarries the selected tenant and the authenticated account subject; the\nclient-supplied tenant selectors are not accepted.\n\nThe API verifies the token, confirms it belongs to the authenticated actor, re-checks the live grant, and applies tenant isolation for the request.\n",
        "schema": {
          "type": "string"
        },
        "example": "<tenant-context token from POST /v1/me/tenant-context>"
      },
      "WorkroomId": {
        "name": "workroom_id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "x-axiom-identifier-classification": "opaque-resource-id",
          "x-axiom-identifier-shape": "alpha-exception",
          "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
        }
      }
    },
    "schemas": {
      "AccountGrant": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "grant_id",
          "account_id",
          "role",
          "valid_until",
          "created"
        ],
        "properties": {
          "grant_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "account_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "role": {
            "type": "string",
            "const": "tenant_user"
          },
          "valid_until": {
            "type": "string",
            "format": "date-time"
          },
          "created": {
            "type": "boolean"
          },
          "audit_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      },
      "AccountGrantRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "role",
          "evidence_ref",
          "valid_until"
        ],
        "properties": {
          "role": {
            "type": "string",
            "const": "tenant_user"
          },
          "evidence_ref": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512
          },
          "valid_until": {
            "type": "string",
            "format": "date-time",
            "description": "Explicit finite future expiry, stored at microsecond precision and fixed across retries."
          }
        }
      },
      "AccountGrantResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data"
            ],
            "properties": {
              "data": {
                "$ref": "#/components/schemas/AccountGrant"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "AccountPartyLink": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "account_id",
          "party_id",
          "created"
        ],
        "properties": {
          "account_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "created": {
            "type": "boolean"
          },
          "audit_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Present on creation; identical repeats create no new audit event.",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        }
      },
      "AccountPartyLinkRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "party_id",
          "evidence_ref"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "evidence_ref": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512
          },
          "expected_party_id": {
            "type": "null",
            "description": "Initial binding only; non-null values are rejected."
          }
        }
      },
      "AccountPartyLinkResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data"
            ],
            "properties": {
              "data": {
                "$ref": "#/components/schemas/AccountPartyLink"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "ActivateProductRequest": {
        "type": "object",
        "properties": {
          "activated_by": {
            "type": "string",
            "deprecated": true,
            "description": "Retired compatibility field. Product activation attribution is derived from the authenticated actor context and this value is ignored.\n",
            "example": "usr_3f8a"
          }
        },
        "additionalProperties": false
      },
      "AddBusinessRuleRequest": {
        "type": "object",
        "required": [
          "code",
          "name",
          "rule_type",
          "expression",
          "priority"
        ],
        "properties": {
          "code": {
            "type": "string",
            "maxLength": 50,
            "pattern": "^[A-Za-z0-9_.:-]+$",
            "description": "Machine-readable rule code (must be unique within the ruleset)",
            "example": "max-sum-insured"
          },
          "name": {
            "type": "string",
            "description": "Human-readable rule name",
            "example": "Maximum Sum Insured Limit"
          },
          "rule_type": {
            "type": "string",
            "enum": [
              "validation",
              "calculation",
              "condition",
              "action",
              "commission_rate",
              "commission_split",
              "group_discount",
              "discount_composition"
            ],
            "description": "Classification of the rule's purpose",
            "example": "validation"
          },
          "expression": {
            "type": "string",
            "description": "CEL expression for rule evaluation. Both complex expressions\n(e.g., \"cover.sum_insured <= 50000000\") and bare literals\n(e.g., \"25000\") are valid CEL. JSON request facts may bind numeric\nvalues as CEL double values; use explicit int(), uint(), or double()\nconversions when an operator requires a specific numeric type.\n",
            "example": "25000"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-readable explanation of the rule",
            "example": "Sum insured must not exceed KES 50,000,000 for standard home contents policies"
          },
          "priority": {
            "type": "integer",
            "description": "Execution priority (lower executes first)",
            "example": 20
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Optional rule metadata",
            "example": {
              "regulatory_ref": "IRA-KE-2025-HC-7"
            }
          },
          "conditions": {
            "type": [
              "array",
              "null"
            ],
            "deprecated": true,
            "items": {
              "$ref": "#/components/schemas/RuleCondition"
            },
            "description": "Legacy compatibility metadata only. Conditions are not executable rule\nauthority in the governed ruleset runtime; the CEL `expression` field is\nthe sole executable rule body.\n"
          },
          "actions": {
            "type": [
              "array",
              "null"
            ],
            "deprecated": true,
            "items": {
              "$ref": "#/components/schemas/RuleAction"
            },
            "description": "Legacy compatibility metadata only. Actions are preserved for historical\nrulepack round-trip evidence but are not executed by the ruleset runtime.\n"
          }
        },
        "additionalProperties": false
      },
      "AddCoverItemRequest": {
        "type": "object",
        "required": [
          "code",
          "name",
          "type"
        ],
        "properties": {
          "code": {
            "type": "string",
            "example": "gp-consultation",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "example": "GP Consultation"
          },
          "description": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "description": "Catalogue-driven cover-item kind code.",
            "example": "hospital-service",
            "x-axiom-coded-value-classification": "tenant-catalogue-type"
          },
          "classification": {
            "type": "string"
          },
          "response_amount_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "description": "Configured cover-item response amount in exact integer minor units. Requires response_amount_currency_code when present.",
            "example": 250000
          },
          "response_amount_currency_code": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code for response_amount_minor. Omit when response_amount_minor is absent.",
            "example": "zar"
          },
          "response_percentage_bps": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 10000,
            "description": "Configured cover-item response percentage in basis points; 10000 means 100%.",
            "example": 8000
          },
          "per_assertion_limit_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "description": "Per-assertion cover-item limit in exact integer minor units. Requires per_assertion_limit_currency_code when present.",
            "example": 100000
          },
          "per_assertion_limit_currency_code": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code for per_assertion_limit_minor. Omit when per_assertion_limit_minor is absent.",
            "example": "zar"
          },
          "annual_limit_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "description": "Annual cover-item limit in exact integer minor units. Requires annual_limit_currency_code when present.",
            "example": 1000000
          },
          "annual_limit_currency_code": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code for annual_limit_minor. Omit when annual_limit_minor is absent.",
            "example": "zar"
          },
          "trigger_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Governed event-trigger-kind identifiers for this cover item. These identify catalogue entries without making sector trigger text part of cover-item canon."
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "terms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/AddCoverTermRequest"
            }
          }
        },
        "additionalProperties": false
      },
      "AddCoverRequest": {
        "type": "object",
        "required": [
          "code",
          "name",
          "type"
        ],
        "properties": {
          "code": {
            "type": "string",
            "description": "Short code for this coverage section",
            "example": "TPL-BODILY",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Display name",
            "example": "Third-Party Bodily Injury"
          },
          "description": {
            "type": "string",
            "description": "Detailed description of coverage",
            "example": "Covers liability for bodily injury to third parties arising from vehicle use"
          },
          "type": {
            "type": "string",
            "enum": [
              "basic",
              "optional",
              "rider"
            ],
            "description": "Coverage type within the product",
            "example": "basic"
          },
          "sum_insured": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Maximum amount payable under this cover in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 100000000
          },
          "deductible": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Excess amount the insured must pay before the cover responds in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 50000
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code required when sum_insured or deductible is present. Omit when neither money field is present.",
            "example": "zar"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes"
          },
          "cover_items": {
            "type": [
              "array",
              "null"
            ],
            "description": "CRS-3: nested cover items, each with its own terms. Persisted as the full\ncanonical cover.* row graph in one atomic transaction.\n",
            "items": {
              "$ref": "#/components/schemas/AddCoverItemRequest"
            }
          },
          "cover_terms": {
            "type": [
              "array",
              "null"
            ],
            "description": "CRS-3: nested cover-level terms (conditions, limits, exclusions).",
            "items": {
              "$ref": "#/components/schemas/AddCoverTermRequest"
            }
          }
        },
        "additionalProperties": false
      },
      "AddCoverTermRequest": {
        "type": "object",
        "required": [
          "code",
          "name",
          "type"
        ],
        "properties": {
          "code": {
            "type": "string",
            "example": "annual-limit",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "example": "Annual Limit"
          },
          "description": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "description": "Term type (condition | limit | exclusion | excess).",
            "example": "limit",
            "x-axiom-coded-value-classification": "tenant-catalogue-type"
          },
          "expression": {
            "type": "string",
            "description": "Rule expression for the term (rules-as-data)."
          },
          "boundary": {
            "$ref": "#/components/schemas/HierarchyTermBoundary"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          }
        },
        "additionalProperties": false
      },
      "AddPartyGroupMemberRequest": {
        "type": "object",
        "description": "Exactly one of party_id or group_id must be supplied. Passing neither\nor both is rejected with 400. fail-loud.\n",
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "group_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Defaults to now() server-side when omitted"
          }
        },
        "additionalProperties": false
      },
      "AddSupportRequestMessageRequest": {
        "type": "object",
        "required": [
          "body"
        ],
        "properties": {
          "body": {
            "type": "string",
            "minLength": 1
          },
          "adapter_ref": {
            "type": "string"
          },
          "correlation_id": {
            "type": "string",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "ArchiveIngestResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/archiveObjectDTO"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ArchiveState": {
        "type": "string",
        "enum": [
          "staged",
          "archived",
          "dead_letter"
        ],
        "description": "Storage-leg state (governed contract)."
      },
      "AssembleEvidencePackRequest": {
        "type": "object",
        "required": [
          "name",
          "record_ids"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Descriptive name for the evidence pack",
            "example": "Policy POL-2026-00089 \u2014 Underwriting Evidence Pack"
          },
          "record_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "typed-prefix-id"
            },
            "description": "List of evidence record IDs to include in the pack",
            "example": [
              "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
              "evd_01K4Q5K9CNKPV5E3R2EEDJQJ1F"
            ]
          },
          "assembled_by": {
            "type": "string",
            "description": "Identifier of the user or service assembling the pack",
            "example": "underwriting-service"
          }
        },
        "additionalProperties": false
      },
      "AssertionAssessmentReplayVerificationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "description": "Strict replay of the pipeline execution an assessment assertion records (governed contract). A non-binding check of a retained decision: it never re-adjudicates, changes status or creates a payment; the assertion remains the decision of record.\n",
                "required": [
                  "assertion_id",
                  "status",
                  "evidence_entry_id",
                  "stored_explanation_root_id",
                  "replayed_explanation_root_id",
                  "pipeline_template_id",
                  "pipeline_template_version"
                ],
                "properties": {
                  "assertion_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "description": "The assessment assertion whose execution was replayed.",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "verified",
                      "diverged"
                    ],
                    "description": "verified when re-execution from the frozen inputs reproduces the fingerprint the assertion names and the assertion records the replayed outcome and amount; diverged otherwise. A divergence is a finding about the retained decision, not a request error.\n"
                  },
                  "divergence": {
                    "type": "string",
                    "enum": [
                      "execution_fingerprint",
                      "assertion_record"
                    ],
                    "description": "Present when status is diverged. execution_fingerprint: re-execution produced a different fingerprint. assertion_record: the execution reproduces, but the assertion's recorded outcome or amount differs.\n"
                  },
                  "evidence_entry_id": {
                    "type": "integer",
                    "format": "int64",
                    "description": "Evidence journal entry of the retained execution that was replayed."
                  },
                  "stored_explanation_root_id": {
                    "type": "string",
                    "description": "Semantic fingerprint the assertion names.",
                    "x-axiom-identifier-classification": "opaque-resource-id",
                    "x-axiom-identifier-shape": "alpha-exception",
                    "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                  },
                  "replayed_explanation_root_id": {
                    "type": "string",
                    "description": "Semantic fingerprint of the re-execution.",
                    "x-axiom-identifier-classification": "opaque-resource-id",
                    "x-axiom-identifier-shape": "alpha-exception",
                    "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                  },
                  "pipeline_template_id": {
                    "type": "string",
                    "description": "Retained pipeline template identity the replay selected.",
                    "x-axiom-identifier-classification": "opaque-resource-id",
                    "x-axiom-identifier-shape": "alpha-exception",
                    "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                  },
                  "pipeline_template_version": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Retained pipeline template version the replay selected."
                  },
                  "stored_contract_response": {
                    "type": "string",
                    "description": "Contract response retained with the original execution."
                  },
                  "stored_payment_amount": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/Money"
                      }
                    ],
                    "description": "Payable amount retained with the original execution, when one was priced."
                  },
                  "replayed_contract_response": {
                    "type": "string",
                    "description": "Contract response re-derived from the frozen inputs."
                  },
                  "replayed_payment_amount": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/Money"
                      }
                    ],
                    "description": "Payable amount re-derived from the frozen inputs, when one was priced."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "AssessClaimRequest": {
        "type": "object",
        "properties": {
          "assessed_by": {
            "type": "string",
            "description": "Identifier of the assessor performing the assessment",
            "example": "assessor-jvd-001"
          },
          "assessment_notes": {
            "type": "string",
            "description": "Detailed notes from the assessment",
            "example": "Site inspection completed. Damage consistent with reported cause. Recommended approval less policy excess of R5,000."
          },
          "approved_amount": {
            "type": [
              "object",
              "null"
            ],
            "description": "Approved assertion amount. Null if recommending denial.",
            "properties": {
              "amount_minor": {
                "type": "integer",
                "format": "int64",
                "description": "Amount in exact integer minor units (e.g. cents). Never float.",
                "minimum": 0,
                "example": 8000000
              },
              "currency_code": {
                "type": "string",
                "pattern": "^[a-z]{3}$",
                "description": "Lowercase ISO-4217 currency code. Must be non-empty.",
                "example": "zar"
              }
            }
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Operational metadata for the assessment",
            "example": {
              "inspection_date": "2026-03-05",
              "photos_attached": 12
            }
          },
          "primary_payer_allowed_amount": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "The primary payer's allowed amount for the charge. Supply together with primary_payer_paid_amount, in the currency of the assessed lines. Both are frozen into the assessment facts as primary_payer_allowed_amount_minor and primary_payer_paid_amount_minor, so shortfall rules read them and strict replay re-derives the decision from them (governed contract). Omit both when the product's rules do not use them.\n"
          },
          "primary_payer_paid_amount": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "What the primary payer paid towards the charge. Supply together with primary_payer_allowed_amount, in the same currency.\n"
          }
        },
        "additionalProperties": false
      },
      "AssessClaimResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "claim",
                  "assessment"
                ],
                "properties": {
                  "claim": {
                    "$ref": "#/components/schemas/Claim"
                  },
                  "assessment": {
                    "type": "array",
                    "description": "Rule evaluation results from tenant-specific adjudication.",
                    "items": {
                      "type": "object",
                      "required": [
                        "rule_id",
                        "rule_name",
                        "outcome",
                        "value",
                        "executed_at"
                      ],
                      "properties": {
                        "rule_id": {
                          "type": "string",
                          "x-axiom-identifier-classification": "rule-reference",
                          "x-axiom-identifier-shape": "alpha-exception",
                          "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                        },
                        "rule_name": {
                          "type": "string"
                        },
                        "outcome": {
                          "type": "string"
                        },
                        "value": {},
                        "executed_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "error": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "explanation_tree_id": {
                    "type": "string",
                    "description": "Persisted explanation-tree receipt identifier when produced.",
                    "x-axiom-identifier-classification": "explanation-tree-id",
                    "x-axiom-identifier-shape": "opaque-string"
                  },
                  "resolved_rule_versions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "resolved_at",
                        "resolution_basis"
                      ],
                      "properties": {
                        "resolved_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "resolution_basis": {
                          "type": "string"
                        },
                        "rule_id": {
                          "type": "string",
                          "x-axiom-identifier-classification": "rule-reference",
                          "x-axiom-identifier-shape": "alpha-exception",
                          "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                        },
                        "rule_name": {
                          "type": "string"
                        },
                        "version": {
                          "type": "integer"
                        }
                      },
                      "additionalProperties": false
                    }
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "AssignGroupRoleRequest": {
        "type": "object",
        "required": [
          "role_type",
          "context"
        ],
        "properties": {
          "role_type": {
            "type": "string",
            "enum": [
              "sponsor",
              "provider",
              "beneficiary",
              "accepted_provider_network"
            ],
            "example": "accepted_provider_network"
          },
          "context": {
            "type": "object",
            "required": [
              "entity_type",
              "entity_id"
            ],
            "properties": {
              "entity_type": {
                "type": "string",
                "enum": [
                  "policy",
                  "claim",
                  "organization",
                  "product",
                  "policy_item"
                ],
                "example": "product"
              },
              "entity_id": {
                "type": "string",
                "example": "ref_01arz3ndektsv4rrffq69g5fav",
                "format": "typed-prefix-id",
                "x-axiom-identifier-classification": "typed-prefix-wire-id",
                "x-axiom-identifier-shape": "typed-prefix"
              }
            },
            "additionalProperties": false
          },
          "effective_from": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "AuditRecentEntry": {
        "type": "object",
        "required": [
          "id",
          "action",
          "subject_type",
          "subject_id",
          "actor",
          "timestamp"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^aud_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Audit entry identifier",
            "example": "aud_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "audit-log-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "action": {
            "type": "string",
            "description": "Action performed. Common values include created, updated, deleted,\nstate_transition, login, evaluation, and approval.\n",
            "example": "state_transition"
          },
          "subject_type": {
            "type": "string",
            "description": "Type of the entity acted upon",
            "example": "assertion"
          },
          "subject_id": {
            "type": "string",
            "description": "Identifier of the entity acted upon",
            "example": "audit_entry_20260408_0001",
            "x-axiom-identifier-classification": "audit-subject-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor": {
            "type": "string",
            "description": "Identifier of the user or service that performed the action.",
            "example": "assertion-assessor@tenant.example.com"
          },
          "details": {
            "type": "object",
            "additionalProperties": true,
            "description": "Action-specific details. For state_transition, includes from_state and\nto_state. For updates, includes changed fields.\n",
            "example": {
              "from_state": "open",
              "to_state": "under_investigation",
              "reason": "Assigned to assessor for inspection"
            }
          },
          "correlation_id": {
            "type": "string",
            "description": "Request correlation ID for tracing",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "When the action occurred",
            "example": "2026-03-12T14:22:00Z"
          }
        },
        "additionalProperties": false
      },
      "AuditRecentListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/AuditRecentEntry"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data",
              "meta"
            ],
            "additionalProperties": true
          }
        ]
      },
      "AuthorisationTransition": {
        "type": "object",
        "required": [
          "id",
          "logical_authorisation_id",
          "entity_type",
          "entity_id",
          "transition_kind",
          "authorisation_kind",
          "authorising_actor",
          "decision_date",
          "explanation_node_id",
          "valid_from",
          "asserted_from"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^atr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "atr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "authorisation-transition-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "logical_authorisation_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^atr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "atr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "authorisation-transition-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "entity_type": {
            "type": "string",
            "enum": [
              "claim"
            ]
          },
          "entity_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "clm_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "claim-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "transition_kind": {
            "type": "string"
          },
          "authorisation_kind": {
            "type": "string"
          },
          "authorising_actor": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "rol_01arz3ndektsv4rrffq69g5fav"
          },
          "authorised_scope": {
            "type": "object",
            "additionalProperties": true
          },
          "budget_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64"
          },
          "budget_currency_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "governing_version_kind": {
            "type": [
              "string",
              "null"
            ]
          },
          "governing_version_row_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "compliance_kind": {
            "type": [
              "string",
              "null"
            ]
          },
          "compliance_outcome": {
            "type": [
              "string",
              "null"
            ]
          },
          "compliance_list_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "compliance_list_authority": {
            "type": [
              "string",
              "null"
            ]
          },
          "decision_date": {
            "type": "string",
            "format": "date-time"
          },
          "explanation_node_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^een_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "een_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "edge-explanation-node-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "finding_reference": {
            "type": [
              "string",
              "null"
            ]
          },
          "valid_from": {
            "type": "string",
            "format": "date-time"
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "BalanceExplanation": {
        "type": "object",
        "required": [
          "inputs",
          "rule_version",
          "computation",
          "entry_ids"
        ],
        "properties": {
          "inputs": {
            "type": "object",
            "additionalProperties": true,
            "description": "Input facts used for the balance computation. Supports explainability\nby recording the exact parameters that produced this result.\n",
            "example": {
              "account_code": "PREM-RCV-001",
              "date_from": "2026-01-01T00:00:00Z",
              "date_to": "2026-03-10T23:59:59Z",
              "include_pending": false
            }
          },
          "rule_version": {
            "type": "string",
            "description": "Version identifier of the balance computation rule applied (as-was semantics)",
            "example": "balance-calc-v2.1.0"
          },
          "computation": {
            "type": "string",
            "description": "Human-readable description of the computation method",
            "example": "Sum of posted credits minus posted debits for account PREM-RCV-001"
          },
          "entry_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of ledger entry IDs included in this balance calculation",
            "example": [
              "ledger_entry_20260408_0001",
              "ledger_entry_20260408_0001"
            ]
          }
        },
        "additionalProperties": false
      },
      "BalanceResult": {
        "type": "object",
        "required": [
          "account_code",
          "as_of",
          "currency",
          "amount",
          "entry_count",
          "explanation"
        ],
        "properties": {
          "account_code": {
            "type": "string",
            "description": "Account code for which the balance was computed",
            "example": "PREM-RCV-001"
          },
          "as_of": {
            "type": "string",
            "format": "date-time",
            "description": "Point-in-time at which the balance was computed",
            "example": "2026-03-10T23:59:59Z"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO 4217 currency code",
            "example": "usd"
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "description": "Net balance amount (debits minus credits) as of the specified timestamp in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 4525075,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "entry_count": {
            "type": "integer",
            "description": "Number of ledger entries included in the balance computation",
            "example": 128
          },
          "explanation": {
            "$ref": "#/components/schemas/BalanceExplanation"
          }
        },
        "additionalProperties": false
      },
      "BalanceResultResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/BalanceResult"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "BaseResource": {
        "type": "object",
        "required": [
          "id",
          "type"
        ],
        "properties": {
          "id": {
            "$ref": "#/components/schemas/ResourceId"
          },
          "type": {
            "type": "string",
            "description": "Resource type name (lowercase, hyphenated)",
            "example": "policy",
            "readOnly": true,
            "x-axiom-coded-value-classification": "tenant-catalogue-type"
          }
        },
        "additionalProperties": false
      },
      "BindQuoteRequest": {
        "type": "object",
        "required": [
          "payment_method",
          "bound_by"
        ],
        "properties": {
          "payment_method": {
            "type": "string"
          },
          "bound_by": {
            "type": "string"
          },
          "parties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuoteParty"
            },
            "description": "Bind-time parties (must match quote snapshot if provided)"
          }
        },
        "additionalProperties": false
      },
      "BindQuoteResult": {
        "type": "object",
        "required": [
          "quote_id"
        ],
        "description": "Result of a successful quote bind operation",
        "properties": {
          "quote_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "qte_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "quote-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_id": {
            "type": "string",
            "description": "Created policy ID (optional, may be absent in multi-product binds)",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Created policy IDs for multi-product binds"
          },
          "premium_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Created premium record IDs"
          },
          "allocation_explanation_tree_id": {
            "type": "string",
            "description": "Explanation tree for premium allocation.",
            "x-axiom-identifier-classification": "allocation-explanation-tree-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "ledger_entry_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Created ledger entry IDs"
          }
        },
        "additionalProperties": false
      },
      "BindQuoteResultResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/BindQuoteResult"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "BusinessRule": {
        "type": "object",
        "required": [
          "id",
          "rule_id",
          "code",
          "name",
          "rule_type",
          "expression",
          "priority",
          "status",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "readOnly": true,
            "description": "Typed-prefix identifier for this rule instance within the ruleset.",
            "example": "rul_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "rule_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "readOnly": true,
            "description": "Canonical typed-prefix rule identifier shared across versions.",
            "example": "rul_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "code": {
            "type": "string",
            "description": "Machine-readable rule code for cross-referencing",
            "example": "min-driver-age",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Human-readable rule name",
            "example": "Minimum Driver Age Rule"
          },
          "rule_type": {
            "type": "string",
            "enum": [
              "validation",
              "calculation",
              "condition",
              "action",
              "commission_rate",
              "commission_split",
              "group_discount",
              "discount_composition"
            ],
            "description": "Classification of the rule's purpose.\n- validation: Checks data correctness and completeness\n- calculation: Computes a derived value\n- condition: Controls conditional evaluation\n- action: Produces an action result\n- commission_rate: Computes a commission rate\n- commission_split: Computes a commission split\n- group_discount: Computes a group discount\n- discount_composition: Composes discount rules\n",
            "example": "validation"
          },
          "expression": {
            "type": "string",
            "description": "CEL (Common Expression Language) expression that evaluates this rule.\nMust be deterministic and side-effect free. JSON request facts may bind\nnumeric values as CEL double values; use explicit int(), uint(), or\ndouble() conversions when an operator requires a specific numeric type\n(for example, int(applicant.age) % 5 == 0).\n",
            "example": "applicant.age >= 18 && applicant.age <= 75"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-readable explanation of what this rule does and why",
            "example": "Drivers must be between 18 and 75 years old for standard motor cover"
          },
          "priority": {
            "type": "integer",
            "description": "Execution priority within the ruleset. Lower numbers execute first.\nRules with the same priority may execute in any order.\n",
            "example": 10
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "deprecated",
              "inactive",
              "disabled",
              "archived"
            ],
            "description": "Lifecycle status of this individual rule.\n- draft: Under development\n- active: Available for evaluation\n- deprecated: No longer evaluated in new transactions\n- inactive, disabled: Historical raw states, read-only write vocabulary\n- archived: Historical archived state; no unarchive operation is implied\nOnly draft, active and deprecated are writable through rule updating.\nOmitted update status preserves any raw live state. Historical inactive\nand disabled values project to non-evaluating domain Draft without\nimplying semantic equality or rewriting their stored values.\n",
            "example": "active"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible metadata for the rule (e.g. regulatory reference, risk category)",
            "example": {
              "regulatory_ref": "FSCA-PPR-2018-S4.3",
              "risk_category": "driver_eligibility"
            }
          },
          "conditions": {
            "type": [
              "array",
              "null"
            ],
            "deprecated": true,
            "items": {
              "$ref": "#/components/schemas/RuleCondition"
            },
            "description": "Legacy compatibility metadata only. Conditions are not executable rule\nauthority in the governed ruleset runtime; the CEL `expression` field is\nthe sole executable rule body.\n"
          },
          "actions": {
            "type": [
              "array",
              "null"
            ],
            "deprecated": true,
            "items": {
              "$ref": "#/components/schemas/RuleAction"
            },
            "description": "Legacy compatibility metadata only. Actions are preserved for historical\nrulepack round-trip evidence but are not executed by the ruleset runtime.\n"
          },
          "annotations": {
            "type": [
              "array",
              "null"
            ],
            "description": "governed contract \u2014 per-element human annotations (\"4GL on steroids\"). Each\nentry explains one element of the rule (e.g. a CEL term) for a human reader.\n",
            "items": {
              "type": "object",
              "properties": {
                "element": {
                  "type": "string",
                  "description": "The element annotated (e.g. a CEL term, a limit, a value_type)."
                },
                "meaning": {
                  "type": "string",
                  "description": "Plain-English explanation of what the element means."
                },
                "source_ref": {
                  "type": "string",
                  "description": "Section/page reference into the source document."
                }
              },
              "additionalProperties": false
            }
          },
          "source_provenance_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "governed contract \u2014 soft reference to the source_provenance record (source URL,\nSHA-256, publication date, markdown + PDF archive objects, section/page anchors).\n"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when this rule was created",
            "example": "2026-01-10T08:30:00Z"
          }
        },
        "additionalProperties": false
      },
      "BusinessRuleResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/BusinessRule"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "CalculationAttributes": {
        "type": "object",
        "description": "Method-conditional calculator attributes; method-specific keys are omitted when not applicable.",
        "required": [
          "paid_amount_minor",
          "earned_amount_minor",
          "unearned_amount_minor",
          "rounding_mode"
        ],
        "properties": {
          "paid_amount_minor": {
            "type": "integer",
            "format": "int64",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "earned_amount_minor": {
            "type": "integer",
            "format": "int64",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "unearned_amount_minor": {
            "type": "integer",
            "format": "int64",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "rounding_mode": {
            "type": "string",
            "enum": [
              "floor_minor_unit"
            ]
          },
          "day_count_convention": {
            "type": "string",
            "description": "Present for `method=pro_rata`."
          },
          "short_rate_table_version": {
            "type": "string",
            "description": "Present for `method=short_rate`."
          },
          "minimum_earned_amount_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Present for `method=minimum_earned`.",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          }
        },
        "additionalProperties": false
      },
      "CancelReserveRequest": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "CarrierConfig": {
        "unevaluatedProperties": false,
        "allOf": [
          {
            "$ref": "#/components/schemas/CarrierConfigFields"
          },
          {
            "type": "object",
            "required": [
              "id",
              "template_category",
              "status",
              "receiver_path",
              "created_at",
              "updated_at",
              "carrier_kind",
              "provider",
              "message_class",
              "locale",
              "api_version",
              "phone_number_id",
              "business_account_id",
              "template_name",
              "template_language",
              "template_parameter_count",
              "access_token_ref",
              "app_secret_ref",
              "verify_token_ref",
              "max_attempts",
              "retry_base_seconds",
              "request_timeout_seconds",
              "dispatch_batch_size",
              "delivery_deadline_seconds",
              "receipt_window_seconds",
              "operator_agreement_ref",
              "processes_outside_republic",
              "transfer_basis"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Typed `ccf_` id.",
                "x-axiom-identifier-classification": "opaque-resource-id",
                "x-axiom-identifier-shape": "alpha-exception",
                "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
              },
              "template_category": {
                "type": "string",
                "enum": [
                  "utility"
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "active",
                  "disabled"
                ]
              },
              "receiver_path": {
                "type": "string",
                "description": "Carrier-receipt path to register with the provider."
              },
              "created_at": {
                "type": "string",
                "format": "date-time"
              },
              "updated_at": {
                "type": "string",
                "format": "date-time"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "CarrierConfigFields": {
        "type": "object",
        "description": "The configuration's fields; the request and response add their own required sets.",
        "properties": {
          "carrier_kind": {
            "type": "string",
            "enum": [
              "whatsapp"
            ]
          },
          "provider": {
            "type": "string",
            "enum": [
              "meta_cloud_api"
            ]
          },
          "message_class": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$",
            "example": "policy-bound"
          },
          "locale": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[A-Z]{2})?$",
            "example": "en"
          },
          "api_version": {
            "type": "string",
            "pattern": "^v[0-9]{1,3}\\.[0-9]{1,3}$",
            "example": "v21.0"
          },
          "phone_number_id": {
            "type": "string",
            "pattern": "^[0-9]{5,32}$",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "business_account_id": {
            "type": "string",
            "pattern": "^[0-9]{5,32}$",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "template_name": {
            "type": "string",
            "pattern": "^[a-z0-9_]+$",
            "maxLength": 512
          },
          "template_language": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(_[A-Z]{2})?$",
            "example": "en"
          },
          "template_parameter_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20
          },
          "access_token_ref": {
            "type": "string",
            "description": "OpenBao reference under tenants/{tenant context}/"
          },
          "app_secret_ref": {
            "type": "string",
            "description": "OpenBao reference under tenants/{tenant context}/"
          },
          "verify_token_ref": {
            "type": "string",
            "description": "OpenBao reference under tenants/{tenant context}/"
          },
          "max_attempts": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10
          },
          "retry_base_seconds": {
            "type": "integer",
            "minimum": 1,
            "maximum": 3600
          },
          "request_timeout_seconds": {
            "type": "integer",
            "minimum": 1,
            "maximum": 60
          },
          "dispatch_batch_size": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "delivery_deadline_seconds": {
            "type": "integer",
            "minimum": 60,
            "maximum": 604800
          },
          "receipt_window_seconds": {
            "type": "integer",
            "minimum": 60,
            "maximum": 604800
          },
          "operator_agreement_ref": {
            "type": "string",
            "minLength": 3
          },
          "processes_outside_republic": {
            "type": "boolean"
          },
          "transfer_basis": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "popia-72-1-a",
              "popia-72-1-b",
              "popia-72-1-c",
              "popia-72-1-d",
              "popia-72-1-e",
              null
            ],
            "description": "Required exactly when processes_outside_republic is true."
          }
        },
        "additionalProperties": false
      },
      "CarrierConfigRequest": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CarrierConfigFields"
          },
          {
            "required": [
              "carrier_kind",
              "provider",
              "message_class",
              "locale",
              "api_version",
              "phone_number_id",
              "business_account_id",
              "template_name",
              "template_language",
              "template_parameter_count",
              "access_token_ref",
              "app_secret_ref",
              "verify_token_ref",
              "max_attempts",
              "retry_base_seconds",
              "request_timeout_seconds",
              "dispatch_batch_size",
              "delivery_deadline_seconds",
              "receipt_window_seconds",
              "operator_agreement_ref",
              "processes_outside_republic"
            ]
          },
          {
            "if": {
              "properties": {
                "processes_outside_republic": {
                  "const": true
                }
              },
              "required": [
                "processes_outside_republic"
              ]
            },
            "then": {
              "required": [
                "transfer_basis"
              ],
              "properties": {
                "transfer_basis": {
                  "type": "string"
                }
              }
            }
          }
        ],
        "unevaluatedProperties": false
      },
      "CatalogueRelationship": {
        "type": "object",
        "required": [
          "id",
          "source_catalogue",
          "source_code",
          "target_catalogue",
          "target_code",
          "relationship_type",
          "scope",
          "effective_from"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "crl_01ARZ3NDEKTSV4RRFFQ69G5FAV",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "source_catalogue": {
            "type": "string"
          },
          "source_code": {
            "type": "string"
          },
          "target_catalogue": {
            "type": "string"
          },
          "target_code": {
            "type": "string"
          },
          "relationship_type": {
            "type": "string",
            "enum": [
              "parent_of",
              "maps_to",
              "member_of",
              "qualifies",
              "excludes",
              "bundles_with",
              "supersedes",
              "interacts_with"
            ]
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "scope": {
            "type": "string",
            "enum": [
              "universal",
              "jurisdiction",
              "tenant"
            ]
          },
          "jurisdiction": {
            "type": [
              "string",
              "null"
            ]
          },
          "effective_from": {
            "type": "string",
            "format": "date-time"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "CatalogueRelationshipBody": {
        "type": "object",
        "required": [
          "target_catalogue",
          "target_code",
          "relationship_type",
          "scope",
          "effective_from"
        ],
        "properties": {
          "source_catalogue": {
            "type": "string",
            "description": "Optional on the single-create endpoint (defaults from\n:catalogue-ref). REQUIRED on the batch endpoint. When set,\nMUST equal the path value \u2014 silent override is forbidden.\n"
          },
          "source_code": {
            "type": "string",
            "description": "Optional on the single-create endpoint (defaults from\n:code). REQUIRED on the batch endpoint when source_catalogue\nis set.\n"
          },
          "target_catalogue": {
            "type": "string"
          },
          "target_code": {
            "type": "string"
          },
          "relationship_type": {
            "type": "string",
            "enum": [
              "parent_of",
              "maps_to",
              "member_of",
              "qualifies",
              "excludes",
              "bundles_with",
              "supersedes",
              "interacts_with"
            ]
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true
          },
          "scope": {
            "type": "string",
            "enum": [
              "universal",
              "jurisdiction",
              "tenant"
            ]
          },
          "jurisdiction": {
            "type": "string",
            "description": "Required when scope=jurisdiction."
          },
          "effective_from": {
            "type": "string",
            "format": "date-time"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "CertificateProjection": {
        "type": "object",
        "required": [
          "policy_id",
          "party_id",
          "version_id",
          "roles",
          "effective_from"
        ],
        "properties": {
          "policy_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Typed-prefix policy identifier (pol_\u2026)",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Typed-prefix insured-party identifier (pty_\u2026)",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "version_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Typed-prefix policy-version identifier (pov_\u2026) at as_of time",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Active role names for this insured party at as_of time"
          },
          "effective_from": {
            "type": "string",
            "format": "date-time",
            "description": "When this insured party's coverage became effective"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When this insured party's coverage ends (null = currently active)"
          }
        },
        "additionalProperties": false
      },
      "CertificateResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/CertificateProjection"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "Claim": {
        "type": "object",
        "required": [
          "id",
          "claim_number",
          "event_id",
          "policy_id",
          "status",
          "primary_party_id",
          "event_date",
          "reported_date",
          "total_claimed_amount",
          "currency_code",
          "description",
          "priority",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Unique retained claim-family compatibility identifier.",
            "readOnly": true,
            "example": "clm_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "claim_number": {
            "type": "string",
            "description": "Human-readable retained claim-family reference number.",
            "readOnly": true,
            "example": "CLM-2026-00042"
          },
          "event_id": {
            "type": "string",
            "description": "Reference to the event associated with this retained compatibility resource.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "event-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "policy_id": {
            "type": "string",
            "description": "Reference to the policy under which this retained assertion is made.",
            "example": "pol_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "status": {
            "$ref": "#/components/schemas/ClaimStatus"
          },
          "primary_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Reference to the primary party for the retained assertion.",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f4",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "event_date": {
            "type": "string",
            "format": "date-time",
            "description": "Date and time when the insured event occurred",
            "example": "2026-02-15T14:30:00Z"
          },
          "reported_date": {
            "type": "string",
            "format": "date-time",
            "description": "Date and time when the retained assertion was reported.",
            "example": "2026-02-16T09:00:00Z"
          },
          "total_claimed_amount": {
            "type": "integer",
            "format": "int64",
            "readOnly": true,
            "deprecated": true,
            "description": "Derived, read-only compatibility field. Equal to SUM(claim_items.claimed_amount). No longer stored as a stored field (governed contract). Amount in the smallest currency unit (e.g. cents). Exact integer representation.\n",
            "example": 4500000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "currency_code": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "readOnly": true,
            "description": "Authoritative aggregate currency, derived from homogeneous retained assertion lines.",
            "example": "zar"
          },
          "description": {
            "type": "string",
            "description": "Free-text description of the event/assertion circumstances.",
            "example": "Rear-end collision at intersection of Main St and 5th Ave. Third-party vehicle damage and whiplash injury to driver."
          },
          "priority": {
            "$ref": "#/components/schemas/ClaimPriority"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible key-value attributes for tenant-specific retained compatibility data.",
            "example": {
              "loss_location": "London, Greater London",
              "police_report_number": "MET-2026-LDN-3321",
              "weather_conditions": "clear"
            }
          },
          "claim_items": {
            "type": [
              "array",
              "null"
            ],
            "description": "Individual retained compatibility line items for this assertion.",
            "items": {
              "$ref": "#/components/schemas/ClaimItem"
            }
          },
          "fraud_score": {
            "type": [
              "string",
              "null"
            ],
            "readOnly": true,
            "description": "Fraud detection score as exact decimal string in [0, 1]. Null when fraud scoring has not been evaluated for this retained assertion. Emitted as a JSON string, never a JSON number (governed contract).\n",
            "example": "0.25"
          },
          "fraud_status": {
            "type": "string",
            "readOnly": true,
            "enum": [
              "not_evaluated",
              "clear",
              "suspicious",
              "confirmed_fraud"
            ],
            "description": "Fraud evaluation status. Closed enum \u2014 no other values are valid. Legacy value \"fraudulent\" is a compatibility alias for ingest only; API responses always use \"confirmed_fraud\".\n",
            "example": "not_evaluated"
          },
          "requires_investigation": {
            "type": "boolean",
            "readOnly": true,
            "description": "Derived from fraud_score >= investigation_threshold. False when fraud scoring has not been evaluated.\n",
            "example": false
          },
          "is_subrogated": {
            "type": "boolean",
            "description": "Whether this retained assertion involves subrogation against a third party.",
            "example": false
          },
          "subrogation_status": {
            "type": "string",
            "readOnly": true,
            "enum": [
              "not_identified",
              "identified",
              "pursuing",
              "partial",
              "completed",
              "abandoned"
            ],
            "description": "Subrogation lifecycle status. Closed enum \u2014 canonical recovery vocabulary locked under the contract. Terminal states: completed, abandoned.\n",
            "example": "not_identified"
          },
          "recovery_status": {
            "type": "string",
            "readOnly": true,
            "enum": [
              "none",
              "pending",
              "partial",
              "completed",
              "abandoned"
            ],
            "description": "Recovery lifecycle status. Closed enum \u2014 canonical recovery vocabulary locked under the contract. Terminal states: completed, abandoned.\n",
            "example": "none"
          },
          "assessments": {
            "type": [
              "array",
              "null"
            ],
            "description": "Assessment records for this retained assertion.",
            "items": {
              "$ref": "#/components/schemas/ClaimAssessment"
            }
          },
          "payments": {
            "type": [
              "array",
              "null"
            ],
            "description": "Payment records for this retained assertion.",
            "items": {
              "$ref": "#/components/schemas/ClaimPayment"
            }
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the retained compatibility resource was created.",
            "readOnly": true,
            "example": "2026-02-16T09:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the retained compatibility resource was last updated.",
            "readOnly": true,
            "example": "2026-02-20T11:30:00Z"
          }
        },
        "additionalProperties": false
      },
      "ClaimAssessment": {
        "type": "object",
        "required": [
          "id",
          "claim_id",
          "assessment_type",
          "assessed_by",
          "assessed_at",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Unique assessment identifier",
            "readOnly": true,
            "example": "cla_01j9zxkp8wqrm2n4v6t5s3d7f6",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "claim_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Reference to the assessed retained assertion.",
            "readOnly": true,
            "example": "clm_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "assessment_type": {
            "type": "string",
            "description": "Type of assessment performed (e.g. initial, supplementary, independent, medical)",
            "example": "initial"
          },
          "assessed_by": {
            "type": "string",
            "description": "Identifier of the assessor (user ID or external reference)",
            "example": "assessor-jvd-001"
          },
          "assessed_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the assessment was completed",
            "example": "2026-02-18T16:00:00Z"
          },
          "status": {
            "type": "string",
            "enum": [
              "approved",
              "denied",
              "partial"
            ],
            "description": "Assessment outcome status:\n- `approved`: Full asserted amount approved\n- `denied`: Assertion denied; no amount approved\n- `partial`: Partial amount approved; less than the total asserted amount\n",
            "example": "approved"
          },
          "approved_amount": {
            "type": [
              "object",
              "null"
            ],
            "description": "Total amount approved by this assessment. Null if denied.",
            "properties": {
              "amount_minor": {
                "type": "integer",
                "format": "int64",
                "description": "Amount in exact integer minor units (e.g. cents). Never float.",
                "example": 4200000
              },
              "currency_code": {
                "type": "string",
                "pattern": "^[a-z]{3}$",
                "description": "Lowercase ISO-4217 currency code. Must be non-empty.",
                "example": "zar"
              }
            }
          },
          "denial_reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reason for denial or partial denial (null if approved)",
            "example": null
          },
          "notes": {
            "type": [
              "string",
              "null"
            ],
            "description": "Free-text assessor notes",
            "example": "All claimed items verified against repair quotations. Approved less R3,000 excess."
          },
          "rule_results": {
            "type": [
              "array",
              "null"
            ],
            "description": "Results from automated rule evaluations during assessment",
            "items": {
              "$ref": "#/components/schemas/RuleEvaluationResult"
            }
          }
        },
        "additionalProperties": false
      },
      "ClaimItem": {
        "type": "object",
        "required": [
          "id",
          "claim_id",
          "item_type",
          "description",
          "claimed_amount",
          "status",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Unique retained claim-family line-item compatibility identifier.",
            "readOnly": true,
            "example": "cli_01j9zxkp8wqrm2n4v6t5s3d7f5",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "claim_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Reference to the parent retained compatibility resource.",
            "readOnly": true,
            "example": "clm_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "item_type": {
            "type": "string",
            "description": "Category of the retained line item (e.g. vehicle_damage, medical, property, liability).",
            "example": "vehicle_damage"
          },
          "description": {
            "type": "string",
            "description": "Detailed description of the asserted item.",
            "example": "Rear bumper replacement and respray \u2014 2024 Toyota Corolla"
          },
          "claimed_amount": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Amount asserted for this item (exact integer minor units + lowercase ISO-4217 currency code)."
          },
          "approved_amount": {
            "type": [
              "object",
              "null"
            ],
            "description": "Amount approved by assessor. Null if not yet assessed.",
            "properties": {
              "amount_minor": {
                "type": "integer",
                "format": "int64",
                "description": "Amount in exact integer minor units (e.g. cents). Never float.",
                "example": 2600000
              },
              "currency_code": {
                "type": "string",
                "pattern": "^[a-z]{3}$",
                "description": "Lowercase ISO-4217 currency code. Must be non-empty.",
                "example": "zar"
              }
            }
          },
          "paid_amount": {
            "type": [
              "object",
              "null"
            ],
            "description": "Amount actually paid for this item. Null if not yet paid.",
            "properties": {
              "amount_minor": {
                "type": "integer",
                "format": "int64",
                "description": "Amount in exact integer minor units (e.g. cents). Never float.",
                "example": 2600000
              },
              "currency_code": {
                "type": "string",
                "pattern": "^[a-z]{3}$",
                "description": "Lowercase ISO-4217 currency code. Must be non-empty.",
                "example": "zar"
              }
            }
          },
          "service_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Date when the service or repair was performed",
            "example": "2026-03-01T08:00:00Z"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible key-value attributes for this retained line item.",
            "example": {
              "repair_shop": "Cape Auto Body",
              "part_numbers": [
                "TB-2024-RR-01",
                "PS-2024-FW-03"
              ]
            }
          },
          "status": {
            "type": "string",
            "description": "Current status of this retained line item.",
            "example": "approved",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          },
          "salvage_status": {
            "type": "string",
            "readOnly": true,
            "enum": [
              "not_applicable",
              "identified",
              "pursuing",
              "partial",
              "completed",
              "abandoned"
            ],
            "description": "Salvage lifecycle status for this retained line item. Closed enum \u2014 canonical recovery vocabulary locked under the contract. Terminal states: completed, abandoned.\n",
            "example": "not_applicable"
          },
          "salvage_amount": {
            "type": "string",
            "readOnly": true,
            "description": "Salvage recovery amount as exact decimal string in the smallest currency unit (e.g. cents). Emitted as a JSON string, never a JSON number (governed contract).\n",
            "example": "0",
            "x-axiom-money-classification": "decimal-string-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the retained line item was created.",
            "readOnly": true,
            "example": "2026-02-16T09:00:00Z"
          }
        },
        "additionalProperties": false
      },
      "ClaimListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Claim"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ClaimPayment": {
        "type": "object",
        "required": [
          "id",
          "claim_id",
          "payment_id",
          "amount_paid",
          "payment_method",
          "processed_at",
          "processed_by",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Unique retained claim-family payment compatibility identifier.",
            "readOnly": true,
            "example": "cpy_01j9zxkp8wqrm2n4v6t5s3d7f7",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "claim_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Reference to the parent retained compatibility resource.",
            "readOnly": true,
            "example": "clm_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "payment_id": {
            "type": "string",
            "description": "Reference to the payment record in the billing system",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "payment-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "amount_paid": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Amount disbursed in this payment (exact integer minor units + lowercase ISO-4217 currency code)."
          },
          "payment_method": {
            "type": "string",
            "description": "Method used for payment disbursement",
            "example": "bank_transfer"
          },
          "processed_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the payment was processed",
            "example": "2026-02-25T10:00:00Z"
          },
          "processed_by": {
            "type": "string",
            "description": "Identifier of the user or system that processed the payment",
            "example": "payments-officer-mk-003"
          },
          "status": {
            "type": "string",
            "description": "Current payment status",
            "example": "processed",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          },
          "authorisation_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "governed contract authorisation row cited by this payment, when present.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01"
          },
          "authorisation_gate_outcome": {
            "type": [
              "string",
              "null"
            ],
            "description": "Outcome returned by the authorisation payment gate for a cited authorisation.",
            "enum": [
              "clear",
              "override",
              "not-applicable"
            ],
            "example": "clear"
          }
        },
        "additionalProperties": false
      },
      "ClaimPaymentLedgerEntry": {
        "type": "object",
        "required": [
          "entry_id",
          "transaction_id",
          "account_code",
          "entry_type",
          "amount_minor",
          "currency_code",
          "entity_type",
          "entity_id",
          "content_sha256"
        ],
        "properties": {
          "entry_id": {
            "type": "string",
            "description": "Durable ledger entry identifier accepted by the ledger reversal endpoint.",
            "example": "ledger_entry_claim_payment_0001",
            "x-axiom-identifier-classification": "ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "transaction_id": {
            "type": "string",
            "description": "Shared transaction identifier for the balanced payment ledger batch.",
            "example": "txn_claim_payment_0001",
            "x-axiom-identifier-classification": "ledger-transaction-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "account_code": {
            "type": "string",
            "example": "LIABILITY_CLAIMS_PAYABLE"
          },
          "entry_type": {
            "type": "string",
            "enum": [
              "debit",
              "credit"
            ]
          },
          "amount_minor": {
            "type": "integer",
            "format": "int64",
            "example": 8000000
          },
          "currency_code": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "example": "zar"
          },
          "entity_type": {
            "type": "string",
            "example": "claim"
          },
          "entity_id": {
            "type": "string",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "claim-payment-ledger-entity-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "content_sha256": {
            "type": "string",
            "description": "Canonical content hash of the durable ledger entry.",
            "example": "8c2f1d7d9d4e52f9e3b9f3e72855c78ff4d93d6c7ef16b7a0f8e7f734fd6a9a4"
          }
        },
        "x-axiom-money-classification": "flattened-runtime-money-wire-shape",
        "x-axiom-money-currency-association": "inline-currency-code-property",
        "x-axiom-money-migration-target": "#/components/schemas/Money",
        "additionalProperties": false
      },
      "ClaimPriority": {
        "type": "string",
        "enum": [
          "low",
          "medium",
          "high",
          "urgent"
        ],
        "description": "Retained claim-family priority level:\n- `low` \u2014 Routine retained assertion, standard handling priority (for example minor property damage)\n- `medium` \u2014 Standard retained assertion requiring timely processing (for example motor accident)\n- `high` \u2014 Significant retained assertion requiring expedited handling (for example business interruption)\n- `urgent` \u2014 Critical retained assertion requiring immediate attention (for example hospitalisation, total loss)\n",
        "example": "medium"
      },
      "ClaimReserve": {
        "type": "object",
        "required": [
          "id",
          "claim_id",
          "policy_id",
          "reserve_type",
          "currency",
          "cover_type",
          "balance_period_start",
          "balance_period_end",
          "cover_limit_minor",
          "initial_amount",
          "current_amount",
          "released_amount",
          "is_active",
          "state",
          "operation",
          "established_at",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "claim_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_id": {
            "type": "string",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-classification": "policy-reference",
            "x-axiom-identifier-alpha-exception": "Retained claim reserves may carry opaque legacy policy references; authenticated tenant-authorised history correction is required before this response can promise pol_ exclusively."
          },
          "reserve_type": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO-4217 currency authoritative for every reserve amount."
          },
          "cover_type": {
            "type": "string",
            "description": "Tenant-configured cover discriminator used for capacity admission."
          },
          "balance_period_start": {
            "type": "string",
            "format": "date-time",
            "description": "Inclusive start of the as-was cover-limit period."
          },
          "balance_period_end": {
            "type": "string",
            "format": "date-time",
            "description": "Inclusive end of the as-was cover-limit period."
          },
          "cover_limit_minor": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "description": "As-was configured cover limit in integer minor units."
          },
          "initial_amount": {
            "type": "integer",
            "format": "int64",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "current_amount": {
            "type": "integer",
            "format": "int64",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "released_amount": {
            "type": "integer",
            "format": "int64",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "is_active": {
            "type": "boolean"
          },
          "state": {
            "type": "string",
            "enum": [
              "active",
              "partially_released",
              "fully_released",
              "inactive_cancelled"
            ]
          },
          "reason": {
            "type": "string"
          },
          "operation": {
            "type": "string"
          },
          "predecessor_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id"
          },
          "successor_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id"
          },
          "established_at": {
            "type": "string",
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "ClaimResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Claim"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ClaimStatus": {
        "type": "string",
        "enum": [
          "submitted",
          "under_review",
          "assessed",
          "partial_approval",
          "denied",
          "paid",
          "closed"
        ],
        "description": "Retained claim-family compatibility lifecycle status. Axiom canon is\nevents/assertions; `ClaimStatus` is a retained public/runtime schema name\nuntil a governed API/schema migration. The retained lifecycle follows this\nstate machine:\n\n```\nsubmitted -> under_review -> assessed ---------> paid -> closed\n                                +-> partial_approval -> paid -> closed\n                                +-> denied ----------------------> closed\n```\n\nTransitions:\n- `submitted` -> `under_review`: Retained assertion enters active review and triage\n- `under_review` -> `assessed`: Full approval \u2014 assessment approves total asserted amount\n- `under_review` -> `partial_approval`: Partial approval \u2014 approved amount is less than asserted\n- `under_review` -> `denied`: Assertion denied; no amount approved\n- `assessed` -> `paid`: Payment disbursed for a fully approved retained assertion\n- `partial_approval` -> `paid`: Payment disbursed for a partially approved retained assertion\n- `paid` -> `closed`: Retained lifecycle complete after payment\n- `denied` -> `closed`: Retained lifecycle complete after denial\n\nNote: The assessment outcome (approved, denied, partial) is recorded on\n`ClaimAssessment.status`, not on `Claim.status`. The retained compatibility\nentity status reflects the overall lifecycle position.\n\nInvalid transitions return HTTP 422 with error code `INVALID_STATE_TRANSITION`.\n\nPer-value descriptions:\n- `submitted`: Retained assertion has been filed and is awaiting initial review\n- `under_review`: Retained assertion is under active assessment by an assessor\n- `assessed`: Assessment complete with full approval; retained assertion is payable\n- `partial_approval`: Assessment complete with partial approval; retained assertion is payable for the approved amount\n- `denied`: Assertion has been denied following assessment; no payment will be made\n- `paid`: Payment has been disbursed to the asserting party\n- `closed`: Retained lifecycle is complete (paid, denied, or otherwise resolved)\n",
        "example": "submitted"
      },
      "Commission": {
        "type": "object",
        "required": [
          "id",
          "role_type",
          "commission_type",
          "rate",
          "calculation_basis",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique commission structure identifier",
            "example": "prd_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "commission-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "role_type": {
            "type": "string",
            "description": "The intermediary role this commission applies to (e.g. broker, agent)",
            "example": "broker"
          },
          "commission_type": {
            "type": "string",
            "description": "Type of commission (e.g. initial, renewal, override)",
            "example": "initial"
          },
          "rate": {
            "type": "number",
            "format": "double",
            "description": "Commission rate (as a decimal, e.g. 0.10 for 10%)",
            "example": 0.1
          },
          "min_amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Minimum commission amount per transaction in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 5000
          },
          "max_amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Maximum commission amount per transaction in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 500000
          },
          "calculation_basis": {
            "type": "string",
            "description": "What the commission rate is applied to (e.g. gross_premium, net_premium)",
            "example": "gross_premium"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Whether this commission structure is currently active",
            "example": "active"
          }
        },
        "additionalProperties": false
      },
      "CommissionAmount": {
        "type": "object",
        "required": [
          "role_type",
          "amount",
          "commission_type"
        ],
        "properties": {
          "role_type": {
            "type": "string",
            "description": "Role of the commission recipient (e.g. broker, underwriting_agent, lead_generator)",
            "example": "broker"
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "description": "Commission amount in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 5750,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "commission_type": {
            "type": "string",
            "description": "Type of commission (e.g. initial, renewal, override)",
            "example": "initial"
          }
        },
        "additionalProperties": false
      },
      "CommunicationDetail": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "communication_id",
          "party_id",
          "message_class",
          "dispatched_at",
          "archive_state",
          "archive_id",
          "legs",
          "endpoint_state"
        ],
        "properties": {
          "communication_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "message_class": {
            "type": "string"
          },
          "context": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "entity_type": {
                "type": "string"
              },
              "entity_id": {
                "type": "string",
                "x-axiom-identifier-classification": "opaque-resource-id",
                "x-axiom-identifier-shape": "alpha-exception",
                "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
              }
            }
          },
          "dispatched_at": {
            "type": "string",
            "format": "date-time"
          },
          "archive_state": {
            "$ref": "#/components/schemas/ArchiveState"
          },
          "archive_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "legs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CommunicationLeg"
            }
          },
          "endpoint_state": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "state",
                "observed_at",
                "dispatch_id"
              ],
              "properties": {
                "state": {
                  "type": "string",
                  "enum": [
                    "read"
                  ]
                },
                "observed_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "dispatch_id": {
                  "type": "string",
                  "description": "Typed `cdp_` leg id.",
                  "x-axiom-identifier-classification": "opaque-resource-id",
                  "x-axiom-identifier-shape": "alpha-exception",
                  "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                }
              }
            }
          }
        }
      },
      "CommunicationLeg": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "dispatch_id",
          "channel_kind",
          "status",
          "attempt_count",
          "observations"
        ],
        "properties": {
          "dispatch_id": {
            "type": "string",
            "description": "Typed `cdp_` leg id.",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "channel_kind": {
            "type": "string",
            "enum": [
              "email",
              "sms",
              "push",
              "postal",
              "whatsapp"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "dispatching",
              "dispatched",
              "failed",
              "dead_letter"
            ]
          },
          "attempt_count": {
            "type": "integer"
          },
          "provider_message_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "dead_letter_reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Closed leg reason set when `dead_letter`: `ARCHIVE_UNBOUND`,\n`CARRIER_OUTCOME_UNKNOWN`, `CARRIER_RATE_LIMITED`,\n`CARRIER_NOT_CONFIGURED`, `RETRY_EXHAUSTED`. Distinct from\n`fault_attribution`.\n"
          },
          "failure_code": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "WHATSAPP_CONSENT_MISSING",
              "WHATSAPP_RECIPIENT_CONTACT_INVALID",
              "WHATSAPP_TEMPLATE_MISMATCH",
              "CARRIER_REJECTED",
              null
            ],
            "description": "Set when `failed`: the governed contract precondition code that refused the\nleg at hand-off (`WHATSAPP_CONSENT_MISSING`,\n`WHATSAPP_RECIPIENT_CONTACT_INVALID`, `WHATSAPP_TEMPLATE_MISMATCH`),\nor `CARRIER_REJECTED` for a permanent provider rejection (the\nprovider's code is in the attempt's `fault_attribution`). A failed\nleg is never retried or sent on another channel.\n"
          },
          "observations": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "attempt_n",
                "status",
                "effective_at"
              ],
              "properties": {
                "attempt_n": {
                  "type": "integer"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "queued",
                    "dispatched",
                    "delivered",
                    "bounced",
                    "failed",
                    "expired"
                  ]
                },
                "effective_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "fault_attribution": {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              }
            }
          }
        }
      },
      "CommunicationTemplate": {
        "type": "object",
        "required": [
          "template_id",
          "template_code",
          "message_class_code",
          "current_revision_id",
          "current_version",
          "revision_id",
          "version",
          "supersedes_revision_id",
          "lawful_basis_code",
          "placeholder_schema",
          "response_schema",
          "target_entity_type",
          "channels",
          "renderings",
          "renderings_count",
          "created_by",
          "recorded_at"
        ],
        "properties": {
          "template_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cot_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "template_code": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "message_class_code": {
            "description": "Active code in the operating tenant communications-message-class-za catalogue.",
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "current_revision_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "current_version": {
            "type": "integer",
            "minimum": 1
          },
          "revision_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "version": {
            "type": "integer",
            "minimum": 1
          },
          "supersedes_revision_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$"
          },
          "lawful_basis_code": {
            "description": "Active code in the operating tenant communications-lawful-basis-za catalogue when authoring.",
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "placeholder_schema": {
            "type": "object",
            "additionalProperties": true,
            "description": "Self-contained JSON Schema for personalization. External schema loading is forbidden."
          },
          "response_schema": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "target_entity_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "channels": {
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "email",
                "sms",
                "push",
                "postal",
                "webhook"
              ]
            }
          },
          "renderings": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/CommunicationTemplateRendering"
            }
          },
          "created_by": {
            "type": "string",
            "description": "Optional assertion of authenticated actor identity. A conflicting value is rejected; the server records the authenticated actor."
          },
          "renderings_count": {
            "type": "integer",
            "minimum": 1
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "CommunicationTemplateCreateRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "template_code",
          "message_class_code",
          "lawful_basis_code",
          "placeholder_schema",
          "channels",
          "renderings"
        ],
        "properties": {
          "template_code": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "message_class_code": {
            "description": "Active code in the operating tenant communications-message-class-za catalogue.",
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "lawful_basis_code": {
            "description": "Active code in the operating tenant communications-lawful-basis-za catalogue when authoring.",
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "placeholder_schema": {
            "type": "object",
            "additionalProperties": true,
            "description": "Self-contained JSON Schema for personalization. External schema loading is forbidden."
          },
          "response_schema": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "target_entity_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "channels": {
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "email",
                "sms",
                "push",
                "postal",
                "webhook"
              ]
            }
          },
          "renderings": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/CommunicationTemplateRendering"
            }
          },
          "created_by": {
            "type": "string",
            "description": "Optional assertion of authenticated actor identity. A conflicting value is rejected; the server records the authenticated actor."
          }
        }
      },
      "CommunicationTemplateEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/CommunicationTemplate"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "CommunicationTemplateMutationEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/CommunicationTemplateMutationResult"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "CommunicationTemplateMutationResult": {
        "type": "object",
        "additionalProperties": false,
        "description": "Small acknowledgement of the committed immutable revision. Retrieve complete schemas and rendering content through the current or pinned GET operation.",
        "required": [
          "template_id",
          "template_code",
          "message_class_code",
          "current_revision_id",
          "current_version",
          "revision_id",
          "version",
          "supersedes_revision_id",
          "channels",
          "renderings_count",
          "created_by",
          "recorded_at"
        ],
        "properties": {
          "template_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cot_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "template_code": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "message_class_code": {
            "description": "Active code in the operating tenant communications-message-class-za catalogue.",
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "current_revision_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "current_version": {
            "type": "integer",
            "minimum": 1
          },
          "revision_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "version": {
            "type": "integer",
            "minimum": 1
          },
          "supersedes_revision_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$"
          },
          "channels": {
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "email",
                "sms",
                "push",
                "postal",
                "webhook"
              ]
            }
          },
          "renderings_count": {
            "type": "integer",
            "minimum": 1
          },
          "created_by": {
            "type": "string",
            "description": "Optional assertion of authenticated actor identity. A conflicting value is rejected; the server records the authenticated actor."
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "CommunicationTemplateRenderEnvelope": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/CommunicationTemplateRenderResponse"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "CommunicationTemplateRenderRequest": {
        "type": "object",
        "additionalProperties": false,
        "description": "The complete raw JSON request body is independently limited to 1048576 bytes, including JSON escaping and whitespace; exceeding this wire limit returns 400 INVALID_TEMPLATE_RENDER_INPUT before schema validation. Pinned source is limited to 1048576 UTF-8 bytes; rendered body and subject are each limited to 2097152 UTF-8 bytes.",
        "required": [
          "channel_kind",
          "locale",
          "personalisation"
        ],
        "properties": {
          "channel_kind": {
            "type": "string",
            "enum": [
              "email",
              "sms",
              "push",
              "postal",
              "webhook"
            ]
          },
          "locale": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[A-Z]{2})?$"
          },
          "personalisation": {
            "type": "object",
            "maxProperties": 128,
            "propertyNames": {
              "pattern": "^[A-Za-z_][A-Za-z0-9_]{0,63}$"
            },
            "additionalProperties": {
              "type": "string",
              "maxLength": 65536,
              "description": "At most 65536 UTF-8 bytes per value; the character limit alone does not express this bound."
            },
            "description": "String values only; each value is limited to 65536 UTF-8 bytes, with at most 262144 aggregate UTF-8 key/value bytes. The character maxLength does not replace the byte bound. Stored placeholder schema also applies."
          }
        }
      },
      "CommunicationTemplateRenderResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "template_id",
          "template_code",
          "revision_id",
          "version",
          "channel_kind",
          "locale",
          "subject",
          "body",
          "content_type",
          "renderer",
          "input_sha256",
          "body_sha256",
          "subject_sha256"
        ],
        "properties": {
          "template_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cot_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "template_code": {
            "type": "string"
          },
          "revision_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "version": {
            "type": "integer",
            "minimum": 1
          },
          "channel_kind": {
            "type": "string",
            "enum": [
              "email",
              "sms",
              "push",
              "postal",
              "webhook"
            ]
          },
          "locale": {
            "type": "string"
          },
          "subject": {
            "type": [
              "string",
              "null"
            ]
          },
          "body": {
            "type": "string",
            "maxLength": 2097152
          },
          "content_type": {
            "type": "string",
            "enum": [
              "text/plain",
              "text/html",
              "text/markdown",
              "application/json"
            ]
          },
          "renderer": {
            "type": "string",
            "enum": [
              "axiom-bounded-placeholders/1"
            ]
          },
          "input_sha256": {
            "type": "string",
            "pattern": "^[0-9a-f]{64}$"
          },
          "body_sha256": {
            "type": "string",
            "pattern": "^[0-9a-f]{64}$"
          },
          "subject_sha256": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[0-9a-f]{64}$"
          }
        }
      },
      "CommunicationTemplateRendering": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "channel_kind",
          "locale",
          "body",
          "content_type"
        ],
        "properties": {
          "channel_kind": {
            "type": "string",
            "enum": [
              "email",
              "sms",
              "push",
              "postal",
              "webhook"
            ]
          },
          "locale": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[A-Z]{2})?$"
          },
          "subject": {
            "type": [
              "string",
              "null"
            ],
            "description": "Required for email."
          },
          "body": {
            "type": "string",
            "minLength": 1
          },
          "content_type": {
            "type": "string",
            "enum": [
              "text/plain",
              "text/html",
              "text/markdown",
              "application/json"
            ]
          }
        }
      },
      "CommunicationTemplateRevisionRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "expected_current_revision_id",
          "lawful_basis_code",
          "placeholder_schema",
          "channels",
          "renderings"
        ],
        "properties": {
          "expected_current_revision_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^cor_[0-9a-z]{26}$",
            "description": "The current revision observed by the author. A stale value returns 409 before any revision insertion.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "lawful_basis_code": {
            "description": "Active code in the operating tenant communications-lawful-basis-za catalogue when authoring.",
            "type": "string",
            "minLength": 1,
            "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
          },
          "placeholder_schema": {
            "type": "object",
            "additionalProperties": true,
            "description": "Self-contained JSON Schema for personalization. External schema loading is forbidden."
          },
          "response_schema": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "target_entity_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "channels": {
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "email",
                "sms",
                "push",
                "postal",
                "webhook"
              ]
            }
          },
          "renderings": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/CommunicationTemplateRendering"
            }
          },
          "created_by": {
            "type": "string",
            "description": "Optional assertion of authenticated actor identity. A conflicting value is rejected; the server records the authenticated actor."
          }
        }
      },
      "CompliancePack": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseResource"
          },
          {
            "type": "object",
            "required": [
              "pack_key",
              "jurisdiction",
              "publication_status",
              "version",
              "content_hash"
            ],
            "properties": {
              "pack_key": {
                "type": "string"
              },
              "jurisdiction": {
                "type": "string"
              },
              "publication_status": {
                "type": "string",
                "enum": [
                  "draft",
                  "published",
                  "superseded",
                  "disabled"
                ]
              },
              "version": {
                "type": "integer",
                "minimum": 1
              },
              "content_hash": {
                "type": "string",
                "pattern": "^sha256:[a-f0-9]{64}$"
              },
              "pack": {
                "$ref": "#/components/schemas/CompliancePackDraftRequest"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "CompliancePackDraftRequest": {
        "type": "object",
        "required": [
          "pack_key",
          "jurisdiction",
          "obligations",
          "legal_references",
          "evidence_requirements",
          "retention_obligations"
        ],
        "properties": {
          "pack_key": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_:-]{2,127}$"
          },
          "jurisdiction": {
            "type": "string"
          },
          "obligations": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleObligation"
            }
          },
          "legal_references": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            }
          },
          "evidence_requirements": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            }
          },
          "retention_obligations": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleObligation"
            }
          },
          "time_gates": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "key",
                "duration"
              ],
              "properties": {
                "key": {
                  "type": "string"
                },
                "duration": {
                  "type": "string",
                  "example": "720h"
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "CompliancePackPin": {
        "type": "object",
        "required": [
          "pack_key",
          "pack_version",
          "pack_content_hash"
        ],
        "properties": {
          "pack_key": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_:-]{2,127}$"
          },
          "pack_version": {
            "type": "integer",
            "minimum": 1
          },
          "pack_content_hash": {
            "type": "string",
            "pattern": "^sha256:[a-f0-9]{64}$"
          }
        },
        "additionalProperties": false
      },
      "CompliancePackResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/CompliancePack"
          }
        },
        "additionalProperties": false
      },
      "ComplianceReport": {
        "type": "object",
        "required": [
          "evaluation_id",
          "generated_at",
          "compliance_assertion",
          "findings",
          "explanation_tree_id"
        ],
        "properties": {
          "evaluation_id": {
            "type": "string",
            "x-axiom-identifier-classification": "compliance-evaluation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "compliance_assertion": {
            "type": "boolean",
            "description": "Always false under the governed contract \u2014 reports are evidence-enabling, not compliance-asserting"
          },
          "findings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/JurisdictionFinding"
            }
          },
          "ruleset_metadata": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PackVersionRef"
            }
          },
          "explanation_tree_id": {
            "type": "string",
            "x-axiom-identifier-classification": "compliance-explanation-tree-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "ComplianceReportResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ComplianceReport"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ConsentGrant": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "grant_id",
          "subject_party_id",
          "granting_party_id",
          "consent_class",
          "purpose_code",
          "granted_via",
          "scope",
          "valid_from",
          "valid_to",
          "revocation_reason",
          "recorded_at"
        ],
        "properties": {
          "grant_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Typed `cgr_` id.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "subject_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "granting_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "consent_class": {
            "type": "string"
          },
          "purpose_code": {
            "type": "string"
          },
          "granted_via": {
            "type": "string"
          },
          "scope": {
            "type": "object",
            "description": "The recorded scope; `contact_entity_id` is a typed `cnt_` id.",
            "additionalProperties": false
          },
          "valid_from": {
            "type": "string",
            "format": "date-time"
          },
          "valid_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "revocation_reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "ConsentGrantResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data"
            ],
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ConsentGrant"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "Cover": {
        "type": "object",
        "required": [
          "id",
          "code",
          "name",
          "type",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique cover identifier",
            "pattern": "^cov_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "cov_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "x-axiom-identifier-classification": "cover-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "product_id": {
            "type": "string",
            "readOnly": true,
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Owning Product identity. Addressability does not imply shared reuse.",
            "format": "typed-prefix-id",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "code": {
            "type": "string",
            "description": "Short code identifying this coverage section",
            "example": "INPATIENT",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Display name of the coverage section",
            "example": "Inpatient Hospital Cover"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Detailed description of what this cover provides",
            "example": "Covers hospitalisation, surgery, and intensive care unit stays"
          },
          "type": {
            "type": "string",
            "enum": [
              "basic",
              "optional",
              "rider"
            ],
            "description": "Coverage type within the product.\n- basic: Core coverage included by default\n- optional: Coverage that can be added at the policyholder's discretion\n- rider: Supplementary coverage attached to a base cover\n",
            "example": "basic"
          },
          "sum_insured": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum amount payable under this cover in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 50000000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "deductible": {
            "type": "integer",
            "format": "int64",
            "description": "Amount the insured must pay before the cover responds in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 100000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code for sum_insured and deductible when either money field is present. Omit when neither money field is present.",
            "example": "zar"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes for cover-specific configuration",
            "example": {
              "waiting_period_days": 30,
              "co_payment_percentage": 20
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "deprecated",
              "retired"
            ],
            "description": "Cover lifecycle status.\n- active: Cover is currently available within the product\n- deprecated: Cover is superseded and retained for as-was auditability\n- retired: Cover is no longer available and retained for reconstruction\n",
            "example": "active"
          },
          "cover_items": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/CoverItem"
            },
            "description": "Catalogue-governed cover items associated with this cover"
          },
          "cover_terms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/HierarchyTerm"
            },
            "description": "Terms (conditions, limits, exclusions) specific to this cover"
          },
          "annotations": {
            "type": [
              "array",
              "null"
            ],
            "description": "governed contract \u2014 per-element human annotations (\"4GL on steroids\") explaining\nthe cover for a human (or agent) reader.\n",
            "items": {
              "type": "object",
              "properties": {
                "element": {
                  "type": "string",
                  "description": "The element annotated."
                },
                "meaning": {
                  "type": "string",
                  "description": "Plain-English explanation of what the element means."
                },
                "source_ref": {
                  "type": "string",
                  "description": "Section/page reference into the source document."
                }
              },
              "additionalProperties": false
            }
          },
          "source_provenance_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "governed contract \u2014 soft reference to the source_provenance record (source URL,\nSHA-256, publication date, markdown + PDF archive objects, section/page anchors).\n"
          }
        },
        "additionalProperties": false
      },
      "CoverItem": {
        "type": "object",
        "required": [
          "id",
          "code",
          "name",
          "type"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique cover provision identifier",
            "pattern": "^cit_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "cit_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "x-axiom-identifier-classification": "cover-item-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "code": {
            "type": "string",
            "description": "Short code for this cover provision",
            "example": "SURG-BEN",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Display name",
            "example": "Surgical Benefit"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Detailed description of the cover provision",
            "example": "Covers elective and emergency surgical procedures"
          },
          "type": {
            "type": "string",
            "description": "Catalogue-driven cover-item kind code. Tenant-sector labels are catalogue\nvalues, not a closed canonical validity set; tenants may add governed\nkind values through the cover-item-kinds catalogue.\n",
            "example": "hospital-service",
            "x-axiom-coded-value-classification": "tenant-catalogue-type"
          },
          "classification": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional classification or grouping for the cover provision",
            "example": "medical"
          },
          "response_amount_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "description": "Configured cover-item response amount in exact integer minor units. Requires response_amount_currency_code when present.",
            "example": 250000
          },
          "response_amount_currency_code": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code for response_amount_minor. Omit when response_amount_minor is absent.",
            "example": "zar"
          },
          "response_percentage_bps": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 10000,
            "description": "Configured cover-item response percentage in basis points; 10000 means 100%.",
            "example": 8000
          },
          "per_assertion_limit_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "description": "Per-assertion cover-item limit in exact integer minor units. Requires per_assertion_limit_currency_code when present.",
            "example": 100000
          },
          "per_assertion_limit_currency_code": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code for per_assertion_limit_minor. Omit when per_assertion_limit_minor is absent.",
            "example": "zar"
          },
          "annual_limit_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "minimum": 0,
            "description": "Annual cover-item limit in exact integer minor units. Requires annual_limit_currency_code when present.",
            "example": 1000000
          },
          "annual_limit_currency_code": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Supported seeded lowercase ISO-4217 currency code for annual_limit_minor. Omit when annual_limit_minor is absent.",
            "example": "zar"
          },
          "trigger_ids": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Governed event-trigger-kind identifiers for this cover item. These identify catalogue entries without making sector trigger text part of cover-item canon."
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes"
          },
          "terms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/HierarchyTerm"
            },
            "description": "Terms specific to this cover provision"
          }
        },
        "additionalProperties": false
      },
      "CoverListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Cover"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "CoverResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Cover"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "CoverSummary": {
        "type": "object",
        "required": [
          "id",
          "product_id",
          "code",
          "name",
          "type",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^cov_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Current logical Cover identity, not its stored revision row.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "product_id": {
            "type": "string",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Owning commercial offering.",
            "format": "typed-prefix-id",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "code": {
            "type": "string",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "x-axiom-coded-value-classification": "tenant-catalogue-type"
          },
          "status": {
            "type": "string",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          }
        },
        "additionalProperties": false
      },
      "CoverSummaryListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CoverSummary"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "CreateConsentGrantRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "granting_party_id",
          "consent_class",
          "purpose_code",
          "granted_via",
          "valid_from"
        ],
        "properties": {
          "granting_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Typed `pty_` party id.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "consent_class": {
            "type": "string",
            "enum": [
              "explicit_consent",
              "contract",
              "legal_obligation",
              "vital_interests",
              "public_task",
              "legitimate_interests"
            ]
          },
          "purpose_code": {
            "type": "string",
            "enum": [
              "claim_assessment",
              "fraud_investigation",
              "policy_underwriting",
              "member_service",
              "regulatory_reporting",
              "analytics_anonymisation",
              "legal_hold",
              "consent_administration",
              "audit_inspection",
              "break_glass_emergency"
            ]
          },
          "granted_via": {
            "type": "string",
            "enum": [
              "paper-form",
              "electronic-form",
              "recorded-call",
              "in-person",
              "messaging-opt-in",
              "self-service-portal"
            ],
            "description": "How the tenant captured the consent. The platform provisioning value\n`alpha-default` (governed contract) is never accepted here.\n"
          },
          "valid_from": {
            "type": "string",
            "format": "date-time"
          },
          "scope": {
            "type": "object",
            "additionalProperties": false,
            "dependentRequired": {
              "channels": [
                "message_classes",
                "contact_entity_id",
                "opt_in_evidence_ref"
              ]
            },
            "description": "A channel opt-in is an `explicit_consent` grant (POPIA governed contract(1)(a))\nthat names `channels`, `message_classes`, the `contact_entity_id` it\ncovers and `opt_in_evidence_ref` (governed contract).\n",
            "properties": {
              "channels": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "sms",
                    "push",
                    "postal",
                    "whatsapp"
                  ]
                }
              },
              "message_classes": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9\\-]*[a-z0-9]$"
                }
              },
              "contact_entity_id": {
                "type": "string",
                "format": "typed-prefix-id",
                "description": "Typed `cnt_` contact id.",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "opt_in_evidence_ref": {
                "type": "string",
                "minLength": 3,
                "maxLength": 256,
                "description": "The tenant's opaque reference to its own record of the party's\nopt-in (for example a form id or call-recording id). It carries no\npersonal information.\n"
              }
            }
          }
        }
      },
      "CreateEvidenceRecordRequest": {
        "type": "object",
        "required": [
          "record_type",
          "subject_type",
          "subject_id",
          "content"
        ],
        "properties": {
          "record_type": {
            "type": "string",
            "description": "Classification of the evidence record",
            "example": "rule_evaluation"
          },
          "subject_type": {
            "type": "string",
            "description": "Type of the entity this evidence pertains to",
            "example": "policy"
          },
          "subject_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Identifier of the subject entity",
            "example": "pol_01K4Q5JPSVE28X56H7E2D8EMBS",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "content": {
            "type": "object",
            "additionalProperties": true,
            "description": "Structured evidence payload",
            "example": {
              "evaluation": "premium_calculation",
              "inputs": {
                "vehicle_value": 450000,
                "driver_age": 32,
                "prior_events_count": 0
              },
              "rule_version": "motor-pricing-v2.0.1",
              "base_premium": 8100,
              "loadings": [],
              "discounts": [
                {
                  "type": "event_free_rating_discount",
                  "percentage": 0.2
                }
              ],
              "final_premium": 6480
            }
          },
          "created_by": {
            "type": "string",
            "description": "Identifier of the creating user or service",
            "example": "pricing-engine"
          }
        },
        "additionalProperties": false
      },
      "CreateEvidenceRecordResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/CreatedEvidenceRecordResource"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "CreateIntegrationInput": {
        "type": "object",
        "required": [
          "system_name",
          "data_categories",
          "data_direction",
          "transfer_method"
        ],
        "properties": {
          "system_name": {
            "type": "string",
            "description": "Name of the external system",
            "example": "MediCheck Claims API"
          },
          "data_categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Categories of data exchanged",
            "example": [
              "health_records",
              "claim_documents"
            ]
          },
          "data_direction": {
            "type": "string",
            "enum": [
              "ingress",
              "egress",
              "bidirectional"
            ],
            "description": "Direction of data flow relative to Axiom",
            "example": "ingress"
          },
          "transfer_method": {
            "type": "string",
            "description": "Technical method for data transfer",
            "example": "rest_api"
          }
        },
        "additionalProperties": false
      },
      "CreatePartyContactRequest": {
        "type": "object",
        "required": [
          "contact_type",
          "contact_data",
          "created_by"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "description": "Optional metadata; the URL party is authoritative.",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "contact_type": {
            "type": "string",
            "enum": [
              "email",
              "phone",
              "address",
              "social"
            ]
          },
          "contact_subtype": {
            "type": "string"
          },
          "is_primary": {
            "type": "boolean"
          },
          "is_active": {
            "type": "boolean"
          },
          "contact_data": {
            "type": "object",
            "additionalProperties": true
          },
          "created_by": {
            "type": "string",
            "description": "Required compatibility metadata; authenticated actor context supplies attribution."
          }
        },
        "additionalProperties": false
      },
      "CreatePartyGroupRequest": {
        "type": "object",
        "required": [
          "display_name"
        ],
        "properties": {
          "group_type": {
            "type": "string",
            "enum": [
              "static",
              "dynamic"
            ],
            "description": "Defaults to static when omitted"
          },
          "display_name": {
            "type": "string",
            "minLength": 1
          },
          "description": {
            "type": "string"
          },
          "external_id": {
            "type": "string",
            "x-axiom-identifier-classification": "tenant-external-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "id_namespace": {
            "type": "string",
            "default": "tenant"
          },
          "membership_rule_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Required when group_type = dynamic",
            "example": "rul_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "CreatePartyIdentityRequest": {
        "type": "object",
        "required": [
          "identity_type",
          "identity_number",
          "created_by"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "description": "Optional metadata; the URL party is authoritative.",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "identity_type": {
            "type": "string",
            "enum": [
              "national_id",
              "passport",
              "drivers_license",
              "tax_id",
              "company_reg"
            ]
          },
          "identity_number": {
            "type": "string",
            "minLength": 1
          },
          "issuing_authority": {
            "type": "string"
          },
          "issued_at": {
            "type": "string",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "description": "Must not precede issued_at."
          },
          "identity_data": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-schema governed identity extensions."
          },
          "verification_status": {
            "type": "string",
            "enum": [
              "pending"
            ],
            "description": "Creation cannot establish verification."
          },
          "created_by": {
            "type": "string",
            "description": "Required compatibility metadata; authenticated actor context supplies attribution."
          }
        },
        "additionalProperties": false
      },
      "CreatePartyRequest": {
        "type": "object",
        "required": [
          "party_type",
          "attributes"
        ],
        "properties": {
          "display_name": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "pattern": "\\S",
            "description": "Tenant-supplied display label, independent of legal-name attributes. Null means no name supplied. Omit on update to preserve the saved value; explicit null clears it. Changes are versioned for as-was replay.",
            "example": "Cedar Engineering (Pty) Ltd"
          },
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Optional client-provided identifier. If omitted, the server generates one.",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_type": {
            "type": "string",
            "enum": [
              "individual",
              "organization",
              "system"
            ],
            "description": "Identity classification of the party. Contextual participation such as broker, provider, agent, adjuster, or assessor belongs to PartyRole.role_type.",
            "example": "individual"
          },
          "external_id": {
            "type": "string",
            "description": "External identifier from source_system. If supplied, source_system is required.",
            "example": "BRK-000123",
            "x-axiom-identifier-classification": "tenant-external-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "source_system": {
            "$ref": "#/components/schemas/PartyExternalIDSourceSystem"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Party-specific data (name, contact details, identifiers, etc.)",
            "example": {
              "first_name": "Takeshi",
              "last_name": "Yamamoto",
              "email": "t.yamamoto@example.jp",
              "phone": "+81312345678"
            }
          },
          "created_by": {
            "type": "string",
            "description": "Identifier of the user or service creating this party",
            "example": "admin-user-001"
          },
          "status": {
            "$ref": "#/components/schemas/PartyLifecycleStatus"
          },
          "merged_into_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Required when status is merged; rejected for non-merged statuses.",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f2",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "CreatePaymentRequest": {
        "type": "object",
        "required": [
          "amount",
          "payment_method",
          "reference_type"
        ],
        "properties": {
          "amount": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Payment amount (exact integer minor units + lowercase ISO-4217 currency code). Must be non-empty."
          },
          "payment_method": {
            "$ref": "#/components/schemas/PaymentMethod"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-readable description of the payment purpose",
            "example": "Ad-hoc premium payment \u2014 health gap cover"
          },
          "reference_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reference to the associated resource (premium, retained claim-family compatibility resource, etc.)",
            "example": "pay_20260403_0001"
          },
          "reference_type": {
            "type": "string",
            "minLength": 1,
            "description": "Business classification of the money movement, and the type of the resource it references. Required \u2014 the server does not default it, because a defaulted classification asserts something the caller never said and is then written to a financial record.",
            "example": "premium"
          },
          "party_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reference to the party associated with this payment. Must be a valid party ID within the tenant.",
            "example": "pty_01arz3ndektsv4rrffq69g5fav"
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible key-value metadata",
            "example": {
              "source": "broker-portal",
              "broker_id": "BRK-0042"
            }
          }
        },
        "additionalProperties": false
      },
      "CreatePolicyRequest": {
        "type": "object",
        "required": [
          "product_id",
          "effective_date",
          "expiry_date",
          "parties"
        ],
        "properties": {
          "product_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Identifier of the product to issue the policy under",
            "example": "prd_01abcdefghjkmnpqrstvwxyz01",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "external_id": {
            "type": "string",
            "description": "Optional caller-supplied external identifier. Fixture and migration\nloaders use this as canonical identity; tenant extension attributes must\nnot duplicate it.\n",
            "example": "seed-pol-CM-GAP-00001",
            "x-axiom-identifier-classification": "tenant-external-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "is_seed_principal": {
            "type": "boolean",
            "description": "Marks a policy created by sanctioned seed/fixture ingestion so demo\ncleanup can target canonical loader-owned records without inspecting\ntenant extension attributes.\n",
            "example": true
          },
          "effective_date": {
            "oneOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "string",
                "format": "date-time"
              }
            ],
            "description": "Date from which the policy provides coverage. YYYY-MM-DD and RFC3339\ndate-time are accepted; runtime normalizes the value before persistence.\n",
            "example": "2026-04-01"
          },
          "expiry_date": {
            "oneOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "string",
                "format": "date-time"
              }
            ],
            "description": "Date on which the policy coverage ends. YYYY-MM-DD and RFC3339 date-time\nare accepted; runtime normalizes the value before persistence.\n",
            "example": "2027-03-31"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Policy-specific data",
            "example": {
              "sum_insured": 250000,
              "territory": "EU"
            }
          },
          "parties": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/PolicyPartyRequest"
            },
            "description": "Parties to assign to the policy (at least one required)"
          },
          "created_by": {
            "type": "string",
            "description": "Optional caller-supplied audit label. Authoritative actor attribution is\nderived from the authenticated actor context when omitted.\n",
            "example": "agent-user-005"
          },
          "binding_mode": {
            "type": "string",
            "enum": [
              "individual",
              "group"
            ],
            "default": "individual",
            "description": "Policy binding mode. When omitted, defaults to \"individual\" for backward\ncompatibility. Set to \"group\" for master policy inception (group/employer/family).\n"
          },
          "group_context": {
            "type": [
              "object",
              "null"
            ],
            "description": "Required when binding_mode=group; must be absent for individual policies.\nDescribes the group contract metadata.\n",
            "properties": {
              "group_type": {
                "type": "string",
                "enum": [
                  "family",
                  "employer"
                ],
                "description": "Type of group arrangement"
              },
              "group_name": {
                "type": "string",
                "description": "Optional display name for the group"
              },
              "external_group_ref": {
                "type": "string",
                "description": "Optional caller-supplied correlation key for the group"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "CreateProductRequest": {
        "type": "object",
        "required": [
          "product_code",
          "name",
          "type",
          "description",
          "currency",
          "covers",
          "terms",
          "attributes"
        ],
        "properties": {
          "product_code": {
            "type": "string",
            "description": "Human-readable product code (must be unique within the tenant)",
            "example": "MOTOR-TPL-2026"
          },
          "name": {
            "type": "string",
            "description": "Display name of the product",
            "example": "Motor Third-Party Liability"
          },
          "type": {
            "type": "string",
            "description": "Product classification",
            "example": "motor",
            "x-axiom-coded-value-classification": "tenant-catalogue-type"
          },
          "description": {
            "type": "string",
            "description": "Detailed description of the product",
            "example": "Mandatory third-party liability cover for motor vehicles"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO-4217 currency code. Uppercase input is accepted and normalized to lowercase canonical form by the runtime.",
            "example": "zar"
          },
          "attributes": {
            "type": "object",
            "required": [
              "base_premium"
            ],
            "properties": {
              "base_premium": {
                "type": "number",
                "description": "Required base premium amount in the smallest currency unit (e.g. cents). Must be positive. governed contract: no silent defaults.",
                "example": 15000,
                "x-axiom-money-classification": "json-number-money-alpha-exception",
                "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
                "x-axiom-money-migration-target": "#/components/schemas/Money",
                "x-axiom-money-risk": "json-number-can-lose-exactness"
              }
            },
            "additionalProperties": true,
            "description": "Product configuration including required base_premium. governed contract: missing base_premium is an error, not a default.",
            "example": {
              "base_premium": 15000,
              "region": "EMEA",
              "regulatory_class": "compulsory"
            }
          },
          "covers": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/AddCoverRequest"
            },
            "description": "Required: at least one coverage section (governed contract: no silent defaults)"
          },
          "terms": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/ProductTermCreate"
            },
            "description": "Required: at least one configurable term (governed contract: no silent defaults). Create-shaped: no server-minted term id (governed contract / governed contract)."
          }
        },
        "additionalProperties": false
      },
      "CreateQuoteRequest": {
        "type": "object",
        "required": [
          "effective_date",
          "expiry_date"
        ],
        "description": "Exactly one of pricing_snapshot_id, products, or product_id must be provided.\npricing_snapshot_id and products are mutually exclusive (422 PRICING_INPUT_CONFLICT).\nIf none is provided, returns 422 PRICING_INPUT_REQUIRED.\n",
        "properties": {
          "pricing_snapshot_id": {
            "type": "string",
            "description": "Reference to a prior rate result snapshot (mutually exclusive with products)",
            "x-axiom-identifier-classification": "pricing-snapshot-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "products": {
            "type": "array",
            "description": "Inline product + risk_profile pairs (mutually exclusive with pricing_snapshot_id)",
            "items": {
              "type": "object",
              "required": [
                "product_id"
              ],
              "properties": {
                "product_id": {
                  "type": "string",
                  "format": "typed-prefix-id",
                  "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
                  "example": "prd_01arz3ndektsv4rrffq69g5fav",
                  "x-axiom-identifier-classification": "product-id",
                  "x-axiom-identifier-shape": "typed-prefix"
                },
                "risk_profile": {
                  "type": "object",
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            }
          },
          "product_id": {
            "type": "string",
            "description": "Legacy single-product shorthand (backward compatible)",
            "format": "typed-prefix-id",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "effective_date": {
            "type": "string",
            "format": "date",
            "example": "2026-04-01"
          },
          "expiry_date": {
            "type": "string",
            "format": "date",
            "example": "2027-04-01"
          },
          "underwriting_data": {
            "type": "object",
            "additionalProperties": true,
            "example": {
              "age": 35,
              "vehicle_value": 25000
            }
          },
          "covers_selected": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "comparison_ref": {
            "type": "string",
            "description": "Links comparison sets for quote comparison"
          },
          "supersedes": {
            "type": "string",
            "description": "Quote ID this quote supersedes"
          },
          "parties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuoteParty"
            },
            "description": "Party snapshot for bind-time matching"
          }
        },
        "additionalProperties": false
      },
      "CreateReserveRequest": {
        "type": "object",
        "required": [
          "reserve_type",
          "amount"
        ],
        "properties": {
          "reserve_type": {
            "type": "string",
            "minLength": 1
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "description": "Initial reserve amount in exact integer minor units.",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "reason": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "CreateReversalResponse": {
        "type": "object",
        "required": [
          "reversal_entry_id",
          "original_entry_id",
          "transaction_id",
          "content_hash",
          "created_at"
        ],
        "properties": {
          "reversal_entry_id": {
            "type": "string",
            "description": "Ledger entry ID for the reversal entry.",
            "example": "rev-http-1",
            "x-axiom-identifier-classification": "ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "original_entry_id": {
            "type": "string",
            "description": "Ledger entry ID that was reversed.",
            "example": "orig-http-1",
            "x-axiom-identifier-classification": "ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "transaction_id": {
            "type": "string",
            "description": "Transaction identifier shared by the reversal posting.",
            "example": "txn-http-1",
            "x-axiom-identifier-classification": "ledger-transaction-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "content_hash": {
            "type": "string",
            "description": "Canonical content hash for the reversal entry.",
            "example": "2f1c0b6e2c8a..."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Time the reversal was created.",
            "example": "2026-04-01T09:10:00Z"
          }
        },
        "additionalProperties": false
      },
      "CreateRulesetRequest": {
        "type": "object",
        "required": [
          "code",
          "name",
          "entity_type",
          "description"
        ],
        "properties": {
          "code": {
            "type": "string",
            "description": "Machine-readable ruleset code (must be unique within the tenant)",
            "example": "home-contents-ke-v1",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Human-readable ruleset name",
            "example": "Kenya Home Contents Insurance"
          },
          "entity_type": {
            "type": "string",
            "enum": [
              "annual_cap",
              "cancellation_and_refunds",
              "claims_assessment",
              "commission",
              "coverage",
              "discount",
              "document_completeness",
              "eligibility",
              "payments",
              "premium_collection",
              "premium_rating",
              "procedure_eligibility",
              "proration_adjustments",
              "rating",
              "regulatory",
              "shortfall_calculation",
              "waiting_periods"
            ],
            "description": "Canonical ruleset_type / pipeline stage this ruleset governs. The\nservice validates this value against ProductRulesetBinding's canonical\nallowlist and rejects retired lane words such as `claims`, `pricing`,\nand `underwriting`.\n",
            "example": "premium_rating"
          },
          "description": {
            "type": "string",
            "description": "Detailed description of the ruleset purpose",
            "example": "Validation and pricing rules for home contents cover in Kenya"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Optional metadata (jurisdiction, product line, etc.)",
            "example": {
              "jurisdiction": "KE",
              "product_line": "home_contents"
            }
          },
          "base_ruleset": {
            "type": [
              "string",
              "null"
            ],
            "description": "Existing ruleset UUID to use as a creation-time template. Codes are not\naccepted for this field. The successor draft receives the next numeric\nversion, lineage metadata in attributes, and copied rules with their\nbusiness codes preserved. This is a bounded compatibility copy path only;\ngoverned evaluation composition uses CompositionResolver / PipelineExecutor\nand live ruleset bindings, not BaseRuleset snapshot inheritance.\n",
            "example": "rst_01abcdefghjkmnpqrstvwxyz01"
          }
        },
        "additionalProperties": false
      },
      "CreateSubprocessorRequest": {
        "type": "object",
        "description": "JSON:API envelope for subprocessor creation request",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "type",
              "attributes"
            ],
            "properties": {
              "type": {
                "type": "string",
                "example": "subprocessors",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "type": "object",
                "required": [
                  "name",
                  "service_scope"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Legal name of the subprocessor",
                    "example": "Azure US East"
                  },
                  "service_scope": {
                    "type": "string",
                    "description": "Services provided by the subprocessor",
                    "example": "Disaster recovery and backup storage"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "CreateSupportRequestRequest": {
        "type": "object",
        "required": [
          "request_class",
          "summary"
        ],
        "properties": {
          "request_class": {
            "type": "string",
            "enum": [
              "support_question",
              "incident",
              "bug_report",
              "integration_help",
              "enhancement_request",
              "feature_request",
              "documentation_request",
              "commercial_request"
            ]
          },
          "summary": {
            "type": "string",
            "minLength": 1
          },
          "details": {
            "type": "string"
          },
          "requester_reference": {
            "type": "string"
          },
          "stated_severity": {
            "type": "string"
          },
          "affected_environment": {
            "type": "string"
          },
          "affected_surface": {
            "type": "string"
          },
          "affected_canonical_noun": {
            "type": "string",
            "enum": [
              "parties_roles",
              "covers_products",
              "policies_versions",
              "premiums_payments",
              "events_assertions"
            ]
          },
          "affected_substrate": {
            "type": "string"
          },
          "correlation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "external_references": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Inert references only; they are not fetched or promoted implicitly."
          },
          "attachment_refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SupportAttachmentReference"
            }
          },
          "agent_context": {
            "$ref": "#/components/schemas/SupportAgentContext"
          },
          "idempotency_key": {
            "type": "string",
            "description": "Body mirror for clients that cannot set Idempotency-Key; header remains preferred."
          }
        },
        "additionalProperties": false
      },
      "CreateVendorRequest": {
        "type": "object",
        "description": "JSON:API envelope for vendor creation request",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "type",
              "attributes"
            ],
            "properties": {
              "type": {
                "type": "string",
                "example": "vendors",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "type": "object",
                "required": [
                  "name",
                  "purpose",
                  "accessed_data_classes",
                  "integrations"
                ],
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Legal or trading name of the vendor",
                    "example": "MediCheck Health Services"
                  },
                  "purpose": {
                    "type": "string",
                    "description": "Business purpose for engaging this vendor",
                    "example": "Medical underwriting and assertion verification"
                  },
                  "classification": {
                    "type": "string",
                    "enum": [
                      "A",
                      "B",
                      "C",
                      "D",
                      "E"
                    ],
                    "description": "Optional compatibility assertion. The active\nvendor-classification ruleset computes the stored\nclassification from accessed_data_classes. If supplied, this\nvalue must match the ruleset-derived classification or the\nrequest fails with CLASSIFICATION_MISMATCH.\n",
                    "example": "C"
                  },
                  "accessed_data_classes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Data classification labels for data the vendor will access",
                    "example": [
                      "health",
                      "personal_identifiable"
                    ]
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "onboarding",
                      "active",
                      "suspended",
                      "offboarded"
                    ],
                    "description": "Initial vendor status (defaults to draft if omitted)",
                    "example": "draft"
                  },
                  "party_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Optional link to an existing Party record",
                    "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
                  },
                  "integrations": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/CreateIntegrationInput"
                    },
                    "description": "Initial integrations to create with the vendor"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "CreatedEvidenceRecordResource": {
        "type": "object",
        "required": [
          "id",
          "type",
          "attributes"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Evidence record identifier.",
            "example": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "type": {
            "type": "string",
            "enum": [
              "evidence"
            ],
            "description": "JSON:API resource type for evidence records."
          },
          "attributes": {
            "type": "object",
            "required": [
              "evidence_id",
              "content_hash",
              "canonicalization_version"
            ],
            "properties": {
              "evidence_id": {
                "type": "string",
                "format": "typed-prefix-id",
                "example": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "content_hash": {
                "type": "string"
              },
              "canonicalization_version": {
                "type": "string",
                "example": "jcs-rfc8785-v1"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "DeclineQuoteRequest": {
        "type": "object",
        "required": [
          "reason_code"
        ],
        "properties": {
          "reason_code": {
            "type": "string",
            "description": "Machine-readable reason for declining the quote"
          }
        },
        "additionalProperties": false
      },
      "EndorsementResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PolicyEndorsement"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "EntityAuditEntry": {
        "type": "object",
        "required": [
          "id",
          "table_name",
          "operation",
          "tenant_id",
          "performed_at",
          "compliance_category",
          "data_classification",
          "purpose",
          "actor_type",
          "actor_id",
          "actor_original_id",
          "rule_versions",
          "summary"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^aud_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "table_name": {
            "type": "string"
          },
          "operation": {
            "type": "string"
          },
          "old_values": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-owned audit content; dynamic snapshot or explanation facts, disclosed only through the existing tenant-authorized audit read."
          },
          "new_values": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-owned audit content; dynamic snapshot or explanation facts, disclosed only through the existing tenant-authorized audit read."
          },
          "user_id": {
            "type": "string",
            "description": "Tenant-confidential audit attribution. Account references render act_ identifiers; non-account service/system names remain opaque attribution; must remain in tenant custody.",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "tenant_id": {
            "type": "string",
            "pattern": "^tnt_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "ip_address": {
            "type": "string",
            "description": "Tenant-confidential audit metadata that may contain personal or technical identifiers; must remain in tenant custody."
          },
          "user_agent": {
            "type": "string",
            "description": "Tenant-confidential audit metadata that may contain personal or technical identifiers; must remain in tenant custody."
          },
          "performed_at": {
            "type": "string",
            "format": "date-time"
          },
          "request_id": {
            "type": "string",
            "x-axiom-identifier-classification": "request-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "patient_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "provider_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "claim_id": {
            "type": "string",
            "pattern": "^clm_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_id": {
            "type": "string",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "format": "typed-prefix-id",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "compliance_category": {
            "type": "string"
          },
          "regulatory_rule": {
            "type": "string"
          },
          "data_classification": {
            "type": "string"
          },
          "purpose": {
            "type": "string"
          },
          "additional_context": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-owned audit content; dynamic snapshot or explanation facts, disclosed only through the existing tenant-authorized audit read."
          },
          "actor_type": {
            "type": "string"
          },
          "actor_id": {
            "type": "string",
            "description": "Account references render act_ identifiers; non-account service/system names remain opaque audit attribution.",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "description": "Account references render act_ identifiers; non-account service/system names remain opaque audit attribution.",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "correlation_id": {
            "type": "string",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "outcome": {
            "type": "string"
          },
          "delegation_id": {
            "type": "string",
            "pattern": "^grt_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "on_behalf_of_party_id": {
            "type": "string",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "impersonated_account_id": {
            "type": "string",
            "pattern": "^act_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "relationship_class_exercised": {
            "type": "string"
          },
          "home_tenant_id": {
            "type": "string",
            "pattern": "^tnt_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "support_session_id": {
            "type": "string",
            "pattern": "^sse_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "support-session-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "decision_id": {
            "type": "string",
            "x-axiom-identifier-classification": "decision-reference",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "operation_code": {
            "type": "string"
          },
          "rule_versions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "inputs": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-owned audit content; dynamic snapshot or explanation facts, disclosed only through the existing tenant-authorized audit read."
          },
          "summary": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "EntityAuditListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data",
              "telemetry",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/EntityAuditEntry"
                }
              },
              "telemetry": {
                "$ref": "#/components/schemas/ResponseTelemetry"
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "Error": {
        "type": "object",
        "required": [
          "status",
          "title"
        ],
        "properties": {
          "status": {
            "type": "string",
            "description": "HTTP status code as a string",
            "example": "422",
            "x-axiom-coded-value-classification": "platform-http-status-code"
          },
          "code": {
            "type": "string",
            "description": "Application-specific error code",
            "example": "VALIDATION_ERROR",
            "pattern": "^[A-Z][A-Z0-9_]*$"
          },
          "title": {
            "type": "string",
            "description": "Short, human-readable summary of the error",
            "example": "Validation Error"
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation of the error",
            "example": "Field 'policy_number' is required"
          },
          "help_url": {
            "type": "string",
            "format": "uri",
            "description": "Documentation URL for this error code",
            "example": "https://developers.afr-dev.axiom.express/api/reference/0.2.126/errors/VALIDATION_ERROR/"
          },
          "source": {
            "$ref": "#/components/schemas/ErrorSource"
          },
          "meta": {
            "type": "object",
            "additionalProperties": true,
            "description": "Additional error metadata"
          }
        },
        "additionalProperties": false
      },
      "ErrorMeta": {
        "type": "object",
        "properties": {
          "correlation_id": {
            "type": "string",
            "description": "Request correlation ID for support reference",
            "example": "req-abc-123-def-456",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "When the error occurred",
            "example": "2026-02-07T12:00:00Z"
          },
          "request_id": {
            "type": "string",
            "description": "Unique request identifier",
            "example": "req-789-ghi",
            "x-axiom-identifier-classification": "request-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "errors"
        ],
        "properties": {
          "errors": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/Error"
            },
            "description": "Array of error objects"
          },
          "meta": {
            "$ref": "#/components/schemas/ErrorMeta"
          },
          "telemetry": {
            "$ref": "#/components/schemas/ResponseTelemetry"
          }
        },
        "additionalProperties": false
      },
      "ErrorSource": {
        "type": "object",
        "properties": {
          "pointer": {
            "type": "string",
            "description": "JSON Pointer to the field that caused the error",
            "example": "/data/attributes/policy_number"
          },
          "parameter": {
            "type": "string",
            "description": "Query parameter that caused the error",
            "example": "filter[status]"
          },
          "header": {
            "type": "string",
            "description": "Header that caused the error",
            "example": "X-Tenant-Context"
          }
        },
        "additionalProperties": false
      },
      "EvaluatePartyGroupRequest": {
        "type": "object",
        "required": [
          "party_id"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "as_of": {
            "type": "string",
            "format": "date-time",
            "description": "Defaults to now() server-side"
          }
        },
        "additionalProperties": false
      },
      "Event": {
        "type": "object",
        "description": "A real-world incident (the events half of the events/assertions paired\nprimitive, governed contract). Read-only projection over the event schema.\n",
        "required": [
          "id",
          "event_type",
          "occurred_at",
          "reported_at",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "format": "typed-prefix-id",
            "pattern": "^evt_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "event-id",
            "x-axiom-identifier-shape": "typed-prefix",
            "example": "evt_01abcdefghjkmnpqrstvwxyz01",
            "description": "Event identity, assigned by the server. Not accepted on report; supplying\none is rejected with 422 `EVENT_ID_NOT_ACCEPTED`.\n\nRendered in canonical typed-prefix form (governed contract): `evt_` followed by\nthe lowercase Crockford Base32 encoding of the storage UUID. This is the\nonly accepted form wherever an event is addressed \u2014 a bare UUID is\nrejected with 400 rather than resolved, so there is exactly one way to\nname an event.\n"
          },
          "event_type": {
            "type": "string",
            "description": "Type of incident: accident, illness, theft, damage, death, etc.",
            "example": "accident"
          },
          "event_subtype": {
            "type": "string"
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the incident occurred"
          },
          "reported_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the incident was reported"
          },
          "validated_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "description": "Event lifecycle status (free-form domain string)",
            "example": "validated",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          },
          "severity": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "coordinates": {
            "type": "object",
            "additionalProperties": true
          },
          "event_details": {
            "type": "object",
            "additionalProperties": true,
            "description": "Domain-specific incident detail payload"
          },
          "primary_party_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "involved_parties": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "policy_id": {
            "type": "string",
            "description": "Reference to the policy the incident is reported against",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_object_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pob_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pob_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-object-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "validation_method": {
            "type": "string"
          },
          "validation_reference": {
            "type": "string"
          },
          "estimated_loss": {
            "type": "integer",
            "format": "int64",
            "description": "Estimated loss in exact integer minor units (governed contract \u2014 never float), paired with currency",
            "example": 5000000
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Known lowercase ISO-4217 currency. Required when estimated_loss is\npresent and must be omitted when estimated_loss is absent (governed contract).\n",
            "example": "zar"
          },
          "requires_notification": {
            "type": "boolean"
          },
          "notification_sent": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "notification_reference": {
            "type": "string"
          },
          "reported_by": {
            "type": "string"
          },
          "source_system": {
            "type": "string"
          },
          "external_reference": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true
          },
          "description": {
            "type": "string",
            "description": "Human-readable event description"
          },
          "investigation_notes": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "EventReportRequest": {
        "type": "object",
        "description": "Multipart event report containing one required `event_data` field and zero\nto ten binary file parts. The complete request body is limited to 64 MiB.\nA request containing more than ten file parts is rejected with HTTP 400 and\ncanonical error code `INVALID_REQUEST`.\n",
        "required": [
          "event_data"
        ],
        "properties": {
          "event_data": {
            "type": "string",
            "description": "JSON object (as a string) describing the event. Supported fields mirror\nthe Event projection's tenant-reportable fields: event_type,\nevent_subtype, occurred_at, reported_at, policy_id, policy_object_id,\nprimary_party_id, event_details, metadata, description, and the other\noptional event facts exposed on the Event schema.\n\n`event_id` is NOT accepted. Event identity is assigned by the server and\nreturned on the response; supplying one is rejected with 422\n`EVENT_ID_NOT_ACCEPTED` rather than ignored, so a caller can never key its\nown records on a value Axiom did not use. To carry your own reference, use\n`external_reference` (with `source_system` to name its origin).\n\nRetry safety is the `Idempotency-Key` header, which is required on this\noperation. `estimated_loss` is exact integer minor units. When it is\npresent, `currency` is required and must be a known lowercase ISO-4217\ncode; when it is absent, `currency` must also be omitted.\n"
          }
        },
        "additionalProperties": {
          "type": "string",
          "format": "binary"
        }
      },
      "EventReportResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/eventReportDTO"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "EvidencePackResource": {
        "type": "object",
        "required": [
          "id",
          "type",
          "attributes"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Evidence pack identifier.",
            "example": "evp_01K4Q5K4MHXSFKQ62B8NQ58WG1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "type": {
            "type": "string",
            "enum": [
              "evidence-pack"
            ],
            "description": "JSON:API resource type for evidence packs."
          },
          "attributes": {
            "type": "object",
            "required": [
              "surface_code",
              "generated_at",
              "pack_hash",
              "evidence_entries"
            ],
            "properties": {
              "surface_code": {
                "type": "string",
                "description": "Regulatory surface used to assemble the pack.",
                "example": "conduct_assertions"
              },
              "generated_at": {
                "type": "string",
                "format": "date-time",
                "description": "Time the evidence pack was generated."
              },
              "inputs_fingerprint": {
                "type": "string",
                "description": "Deterministic fingerprint of the inputs used for assembly."
              },
              "pack_hash": {
                "type": "string",
                "description": "Deterministic hash of the assembled evidence pack."
              },
              "assembly_rules": {
                "type": "object",
                "required": [
                  "pack_id",
                  "pack_version"
                ],
                "properties": {
                  "pack_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "description": "Insurance lifecycle compliance pack typed-prefix identifier.",
                    "example": "ilp_01K4Q5K4MHXSFKQ62B8NQ58WG1",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "pack_version": {
                    "type": "string",
                    "example": "1.0.0"
                  }
                },
                "description": "Compliance pack reference and rule metadata used for assembly.",
                "additionalProperties": false
              },
              "evidence_entries": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": true
                },
                "description": "Evidence entries included in the pack."
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "EvidenceRecord": {
        "type": "object",
        "required": [
          "id",
          "record_type",
          "subject_type",
          "subject_id",
          "content",
          "content_hash",
          "created_at",
          "created_by"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "readOnly": true,
            "description": "Unique evidence record identifier",
            "example": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "record_type": {
            "type": "string",
            "description": "Classification of the evidence record.\nCommon types: decision_trace, approval_record, compliance_check,\nrule_evaluation, state_transition, document_verification.\n",
            "example": "decision_trace"
          },
          "subject_type": {
            "type": "string",
            "description": "Type of the entity this evidence pertains to\n(e.g. policy, event, assertion, premium, party, ruleset).\n",
            "example": "assertion"
          },
          "subject_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Identifier of the entity this evidence pertains to",
            "example": "pol_01K4Q5JPSVE28X56H7E2D8EMBS",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "content": {
            "type": "object",
            "additionalProperties": true,
            "description": "Structured evidence payload. Contents vary by record_type but must\nbe self-contained and reproducible (platform principle \u2014 explainability).\nIncludes inputs, outputs, rule versions, and intermediate results.\n",
            "example": {
              "decision": "assertion_accepted",
              "inputs": {
                "asserted_amount_minor": 1250000,
                "policy_excess_minor": 250000,
                "cover_limit_minor": 50000000
              },
              "rule_version": "motor-assertion-assessment-v3.2.0",
              "evaluation_steps": [
                {
                  "rule": "cover_active_check",
                  "result": true
                },
                {
                  "rule": "excess_applied",
                  "result": true,
                  "excess_amount_minor": 250000
                },
                {
                  "rule": "within_cover_limit",
                  "result": true
                }
              ],
              "contract_response_amount_minor": 1000000
            }
          },
          "content_hash": {
            "type": "string",
            "readOnly": true,
            "description": "SHA-256 hash of the content payload. Enables tamper detection\nand integrity verification without inspecting the full content.\n",
            "example": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the evidence record was created",
            "example": "2026-03-08T14:22:15Z"
          },
          "created_by": {
            "type": "string",
            "readOnly": true,
            "description": "Identifier of the user or service that created this record",
            "example": "assertion-assessment-service"
          }
        },
        "additionalProperties": false
      },
      "EvidenceRecordResource": {
        "type": "object",
        "required": [
          "id",
          "type",
          "attributes"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Evidence record identifier.",
            "example": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "type": {
            "type": "string",
            "enum": [
              "evidence"
            ],
            "description": "JSON:API resource type for evidence records."
          },
          "attributes": {
            "type": "object",
            "required": [
              "content_hash",
              "canonicalization_version",
              "integrity_status",
              "actor_type",
              "actor_id",
              "actor_original_id",
              "evidence_type",
              "entity_id",
              "entity_type",
              "occurred_at",
              "created_at"
            ],
            "properties": {
              "content_hash": {
                "type": "string"
              },
              "canonicalization_version": {
                "type": "string",
                "example": "jcs-rfc8785-v1"
              },
              "integrity_status": {
                "type": "string"
              },
              "actor_type": {
                "type": "string"
              },
              "actor_id": {
                "type": "string",
                "x-axiom-identifier-classification": "actor-id",
                "x-axiom-identifier-shape": "opaque-string"
              },
              "actor_original_id": {
                "type": "string",
                "x-axiom-identifier-classification": "actor-original-id",
                "x-axiom-identifier-shape": "opaque-string"
              },
              "evidence_type": {
                "type": "string"
              },
              "entity_id": {
                "type": "string",
                "format": "typed-prefix-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "entity_type": {
                "type": "string"
              },
              "occurred_at": {
                "type": "string",
                "format": "date-time"
              },
              "created_at": {
                "type": "string",
                "format": "date-time"
              },
              "metadata": {
                "type": "object",
                "additionalProperties": true
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "EvidenceRecordResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/EvidenceRecordResource"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "FamilyAnchorAssignment": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "group_id",
          "party_id",
          "created"
        ],
        "properties": {
          "group_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "created": {
            "type": "boolean"
          }
        }
      },
      "FamilyAnchorAssignmentRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "party_id",
          "evidence_ref"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "evidence_ref": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512
          }
        }
      },
      "FamilyAnchorAssignmentResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data"
            ],
            "properties": {
              "data": {
                "$ref": "#/components/schemas/FamilyAnchorAssignment"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "FamilySummary": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "group_id",
          "display_name",
          "people"
        ],
        "properties": {
          "group_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "display_name": {
            "type": "string"
          },
          "people": {
            "type": "array",
            "maxItems": 256,
            "items": {
              "$ref": "#/components/schemas/FamilySummaryPerson"
            }
          }
        }
      },
      "FamilySummaryPerson": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "party_id",
          "display_name"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "display_name": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "HierarchyTerm": {
        "type": "object",
        "required": [
          "id",
          "code",
          "name",
          "type",
          "parent_type",
          "parent_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique term identifier",
            "example": "cvt_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "hierarchy-term-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "code": {
            "type": "string",
            "description": "Short code for this term",
            "example": "MAX-CLAIM-LIMIT",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Display name",
            "example": "Maximum Claim Limit"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Detailed description of the term",
            "example": "Maximum contract-response amount per event"
          },
          "type": {
            "type": "string",
            "enum": [
              "condition",
              "limit",
              "exclusion"
            ],
            "description": "The kind of term.\n- condition: A prerequisite that must be met for coverage to apply\n- limit: A numeric boundary on coverage (e.g. maximum payout)\n- exclusion: A circumstance under which coverage does not apply\n",
            "example": "limit"
          },
          "parent_type": {
            "type": "string",
            "description": "The type of parent entity (e.g. cover, cover_item)",
            "example": "cover"
          },
          "parent_id": {
            "type": "string",
            "description": "Identifier of the parent entity",
            "example": "cov_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "hierarchy-term-parent-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "expression": {
            "type": [
              "string",
              "null"
            ],
            "description": "CEL expression for evaluating this term",
            "example": "assertion.amount_minor <= 25000000"
          },
          "boundary": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HierarchyTermBoundary"
              },
              {
                "type": "null"
              }
            ]
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes"
          }
        },
        "additionalProperties": false
      },
      "HierarchyTermBoundary": {
        "type": "object",
        "description": "Numeric boundaries for limit-type hierarchy terms",
        "properties": {
          "min": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Minimum boundary value in the smallest currency unit (e.g. cents) when monetary, or in the declared unit otherwise. Exact integer representation.",
            "example": 0
          },
          "max": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Maximum boundary value in the smallest currency unit (e.g. cents) when monetary, or in the declared unit otherwise. Exact integer representation.",
            "example": 50000000
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[A-Z]{3}$",
            "description": "ISO 4217 currency code (when boundary is monetary)",
            "example": "EUR"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unit of measurement (when boundary is non-monetary)",
            "example": "days"
          }
        },
        "additionalProperties": false
      },
      "IngressStatusError": {
        "type": "object",
        "required": [
          "code",
          "message",
          "retryable"
        ],
        "properties": {
          "code": {
            "type": "string",
            "example": "URL_UNREACHABLE",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "message": {
            "type": "string",
            "example": "The supplied evidence URL could not be reached within the validation window."
          },
          "field": {
            "type": "string",
            "example": "payload.evidence_url"
          },
          "retryable": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "IngressStatusTrailEvent": {
        "type": "object",
        "required": [
          "status",
          "recorded_at",
          "correlation_id"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "received",
              "queued",
              "validating",
              "validation_failed",
              "accepted",
              "processing",
              "processing_failed",
              "completed",
              "expired",
              "cancelled",
              "dead_lettered"
            ]
          },
          "stage": {
            "type": "string"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time"
          },
          "correlation_id": {
            "type": "string",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "domain_event_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IngressStatusError"
            }
          }
        },
        "additionalProperties": false
      },
      "Integration": {
        "type": "object",
        "required": [
          "integration_id",
          "vendor_id",
          "system_name",
          "data_categories",
          "data_direction",
          "transfer_method"
        ],
        "properties": {
          "integration_id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique integration identifier",
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "vendor-integration-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "vendor_id": {
            "type": "string",
            "readOnly": true,
            "description": "Vendor this integration belongs to",
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "vendor-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "system_name": {
            "type": "string",
            "description": "Name of the external system being integrated",
            "example": "CloudSure Policy API"
          },
          "data_categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Categories of data exchanged through this integration.\nAligns with data classification policy.\n",
            "example": [
              "policy_data",
              "policyholder_pii",
              "premium_amounts"
            ]
          },
          "data_direction": {
            "type": "string",
            "enum": [
              "ingress",
              "egress",
              "bidirectional"
            ],
            "description": "Direction of data flow relative to Axiom.\n- ingress: Data flows from vendor into Axiom\n- egress: Data flows from Axiom to vendor\n- bidirectional: Data flows in both directions\n",
            "example": "bidirectional"
          },
          "transfer_method": {
            "type": "string",
            "description": "Technical method used for data transfer\n(e.g. rest_api, sftp, webhook, message_queue, batch_file).\n",
            "example": "rest_api"
          }
        },
        "additionalProperties": false
      },
      "IntegrityResult": {
        "type": "object",
        "required": [
          "entry_id",
          "status",
          "failure_code",
          "computed_hash",
          "stored_hash",
          "chain_depth"
        ],
        "properties": {
          "entry_id": {
            "type": "string",
            "description": "Ledger entry checked.",
            "example": "orig-http-1",
            "x-axiom-identifier-classification": "integrity-result-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "status": {
            "type": "string",
            "enum": [
              "PASS",
              "FAIL"
            ],
            "description": "Integrity status for this entry.",
            "example": "PASS"
          },
          "failure_code": {
            "type": "string",
            "enum": [
              "NONE",
              "HASH_MISMATCH",
              "MISSING_LINK",
              "CHAIN_BREAK",
              "NOT_FOUND",
              "OUT_OF_WINDOW"
            ],
            "description": "Outcome code for this entry. `NONE` accompanies `status: PASS`; every\nother value accompanies `status: FAIL`.\n\n- `NONE` \u2014 the stored hash matched the recomputed one and, if the chain\n  was followed, every ancestor matched too.\n- `HASH_MISMATCH` \u2014 the entry's stored `content_hash` does not equal the\n  hash recomputed from its current canonical content, or is empty. An\n  empty stored hash is treated as a mismatch, never as \"not checked\"\n  (governed contract tamper-evidence).\n- `NOT_FOUND` \u2014 no entry with this id exists for the operating tenant.\n- `OUT_OF_WINDOW` \u2014 the entry exists but its processing timestamp is\n  after the requested `as_of_time`, so it is outside the asked-for\n  window. This is an exclusion, not damage.\n- `MISSING_LINK` \u2014 an ancestor referenced by `original_entry_id` does not\n  exist. The lineage points at a row that is not there.\n- `CHAIN_BREAK` \u2014 an ancestor exists but fails its own hash check, or the\n  chain exceeded its 100-link traversal bound.\n",
            "example": "NONE"
          },
          "computed_hash": {
            "type": "string",
            "description": "Hash computed from the current canonical entry content.",
            "example": "2f1c0b6e2c8a..."
          },
          "stored_hash": {
            "type": "string",
            "description": "Hash stored with the entry.",
            "example": "2f1c0b6e2c8a..."
          },
          "chain_depth": {
            "type": "integer",
            "description": "Number of lineage links inspected.",
            "example": 0
          }
        },
        "additionalProperties": false
      },
      "IntegrityVerificationResource": {
        "type": "object",
        "required": [
          "id",
          "type",
          "attributes"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Integrity verification identifier.",
            "example": "eig_01K4Q5K0SCWMJ40BWEFG0C29EM",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "type": {
            "type": "string",
            "enum": [
              "integrity-verification"
            ]
          },
          "attributes": {
            "type": "object",
            "required": [
              "verification_id",
              "expected_hash",
              "actual_hash",
              "status",
              "verified_at"
            ],
            "properties": {
              "verification_id": {
                "type": "string",
                "format": "typed-prefix-id",
                "example": "eig_01K4Q5K0SCWMJ40BWEFG0C29EM",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "expected_hash": {
                "type": "string"
              },
              "actual_hash": {
                "type": "string"
              },
              "status": {
                "type": "string",
                "enum": [
                  "verified",
                  "tampered",
                  "missing",
                  "corrected"
                ]
              },
              "verified_at": {
                "type": "string",
                "format": "date-time"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "IntegrityVerificationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/IntegrityVerificationResource"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "Invoice": {
        "type": "object",
        "description": "Invoice resource. Field-level shape remains runtime-governed until the invoice resource schema is promoted.",
        "additionalProperties": true
      },
      "InvoiceListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Invoice"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "InvoiceResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Invoice"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "JurisdictionFinding": {
        "type": "object",
        "properties": {
          "jurisdiction_code": {
            "type": "string",
            "example": "ZA"
          },
          "status": {
            "type": "string",
            "enum": [
              "pass",
              "fail",
              "needs_review"
            ]
          },
          "evidence_references": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "explanation_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "missing_evidence": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "JSON paths of missing evidence fields"
          }
        },
        "additionalProperties": false
      },
      "LedgerCorrectionsResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/LineageNode"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "LedgerEntry": {
        "type": "object",
        "required": [
          "id",
          "account_code",
          "entry_type",
          "amount",
          "currency",
          "entry_date",
          "status",
          "posted_at",
          "posted_by",
          "reference_type",
          "reference_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique ledger entry identifier",
            "example": "ledger_entry_20260408_0001",
            "x-axiom-identifier-classification": "ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "account_code": {
            "type": "string",
            "description": "Account code identifying the ledger account.\nFollows a hierarchical naming convention (for example premium\nreceivable, assertion-response payable, commission expense).\n",
            "example": "PREM-RCV-001"
          },
          "entry_type": {
            "type": "string",
            "enum": [
              "debit",
              "credit"
            ],
            "description": "Type of ledger entry. Every financial transaction records balanced\ndebit and credit entries.\n- debit: Increases asset/expense accounts, decreases liability/revenue accounts\n- credit: Increases liability/revenue accounts, decreases asset/expense accounts\n",
            "example": "credit"
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "description": "Monetary amount for this entry in the smallest currency unit (e.g. cents). Always positive; direction is determined by entry_type. Exact integer representation.",
            "example": 125000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO 4217 currency code",
            "example": "usd"
          },
          "entry_date": {
            "type": "string",
            "format": "date-time",
            "description": "ISO 8601 timestamp of the accounting date for this entry",
            "example": "2026-03-01T00:00:00Z"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "posted",
              "reversed"
            ],
            "description": "Current status of the ledger entry.\n- pending: Entry created but not yet posted to the ledger\n- posted: Entry has been posted and affects account balances\n- reversed: Entry has been reversed by a correcting entry\n",
            "example": "posted"
          },
          "posted_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the entry was posted",
            "example": "2026-03-01T08:15:30Z"
          },
          "posted_by": {
            "type": "string",
            "readOnly": true,
            "description": "Identifier of the user or service that posted this entry",
            "example": "premium-collection-service"
          },
          "reference_type": {
            "type": "string",
            "description": "Type of the source entity that originated this ledger entry\n(for example premium, assertion, payment, or adjustment).\n",
            "example": "premium"
          },
          "reference_id": {
            "type": "string",
            "description": "Identifier of the source entity that originated this entry",
            "example": "ledger_entry_20260408_0001",
            "x-axiom-identifier-classification": "ledger-reference-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "LedgerEntryListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/LedgerEntry"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "LedgerIntegrityResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/VerifyIntegrityResponse"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "LedgerReversalResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/CreateReversalResponse"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "LifecycleActorAuthority": {
        "type": "object",
        "required": [
          "actor_role",
          "authority_kind"
        ],
        "properties": {
          "actor_role": {
            "type": "string"
          },
          "authority_kind": {
            "type": "string",
            "enum": [
              "tenant_operator",
              "system_actor",
              "regulator",
              "party_in_role"
            ]
          }
        },
        "additionalProperties": false
      },
      "LifecycleBinding": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseResource"
          },
          {
            "type": "object",
            "required": [
              "product_id",
              "lifecycle_purpose",
              "jurisdiction",
              "definition_key",
              "definition_version",
              "definition_content_hash",
              "effective_from",
              "enabled"
            ],
            "properties": {
              "product_id": {
                "type": "string",
                "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
                "format": "typed-prefix-id",
                "example": "prd_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "product-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "lifecycle_purpose": {
                "type": "string"
              },
              "jurisdiction": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9_:-]{1,15}$"
              },
              "definition_key": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9_:-]{2,127}$"
              },
              "definition_version": {
                "type": "integer"
              },
              "definition_content_hash": {
                "type": "string"
              },
              "compliance_pack_pins": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CompliancePackPin"
                }
              },
              "effective_from": {
                "type": "string",
                "format": "date-time"
              },
              "effective_until": {
                "type": "string",
                "format": "date-time"
              },
              "enabled": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "LifecycleBindingRequest": {
        "type": "object",
        "required": [
          "product_id",
          "lifecycle_purpose",
          "jurisdiction",
          "definition_key",
          "definition_version",
          "definition_content_hash",
          "effective_from"
        ],
        "properties": {
          "product_id": {
            "type": "string",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "format": "typed-prefix-id",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "business_object_kind": {
            "type": "string",
            "enum": [
              "policy",
              "replacement",
              "endorsement",
              "claim",
              "assertion",
              "premium",
              "payment"
            ]
          },
          "lifecycle_purpose": {
            "type": "string"
          },
          "jurisdiction": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_:-]{1,15}$"
          },
          "definition_key": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_:-]{2,127}$"
          },
          "definition_version": {
            "type": "integer",
            "minimum": 1
          },
          "definition_content_hash": {
            "type": "string",
            "pattern": "^sha256:[a-f0-9]{64}$"
          },
          "compliance_pack_pins": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CompliancePackPin"
            }
          },
          "effective_from": {
            "type": "string",
            "format": "date-time"
          },
          "effective_until": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "LifecycleBindingResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/LifecycleBinding"
          }
        },
        "additionalProperties": false
      },
      "LifecycleDefinition": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseResource"
          },
          {
            "type": "object",
            "required": [
              "lifecycle_key",
              "product_id",
              "lifecycle_purpose",
              "publication_status",
              "version",
              "content_hash"
            ],
            "properties": {
              "lifecycle_key": {
                "type": "string"
              },
              "product_id": {
                "type": "string",
                "format": "typed-prefix-id",
                "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
                "example": "prd_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "product-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "lifecycle_purpose": {
                "type": "string"
              },
              "publication_status": {
                "type": "string",
                "enum": [
                  "draft",
                  "published",
                  "superseded",
                  "disabled"
                ]
              },
              "version": {
                "type": "integer",
                "minimum": 1
              },
              "content_hash": {
                "type": "string",
                "pattern": "^sha256:[a-f0-9]{64}$"
              },
              "immutable_after_publish": {
                "type": "boolean"
              },
              "definition": {
                "$ref": "#/components/schemas/LifecycleDefinitionDraftRequest"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "LifecycleDefinitionDraftRequest": {
        "type": "object",
        "required": [
          "lifecycle_key",
          "product_id",
          "lifecycle_purpose",
          "initial_state",
          "states",
          "transitions",
          "evidence_obligations",
          "audit_obligations",
          "retention_obligations",
          "explanation_obligations"
        ],
        "properties": {
          "lifecycle_key": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_:-]{2,127}$",
            "description": "Server-scoped lifecycle key. It is not a raw workflow or PipelineTemplate identifier."
          },
          "product_id": {
            "type": "string",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Product or cover catalogue identifier governed by the operating tenant.",
            "format": "typed-prefix-id",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "business_object_kind": {
            "type": "string",
            "enum": [
              "policy",
              "replacement",
              "endorsement",
              "claim",
              "assertion",
              "premium",
              "payment"
            ]
          },
          "lifecycle_purpose": {
            "type": "string",
            "enum": [
              "replacement",
              "endorsement",
              "claim",
              "assertion",
              "premium_collection",
              "payment_schedule",
              "policy_issue",
              "policy_cancellation"
            ]
          },
          "jurisdiction": {
            "type": "string",
            "minLength": 2,
            "maxLength": 16,
            "pattern": "^[a-z][a-z0-9_:-]{1,15}$",
            "example": "za"
          },
          "authoring_kind": {
            "type": "string",
            "enum": [
              "insurance_lifecycle"
            ],
            "description": "Closed authoring kind. Generic workflow, BPMN, raw PipelineTemplate, and raw rule evaluation are rejected."
          },
          "initial_state": {
            "type": "string"
          },
          "terminal_states": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            }
          },
          "states": {
            "type": "array",
            "minItems": 2,
            "items": {
              "$ref": "#/components/schemas/LifecycleState"
            }
          },
          "transitions": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleTransition"
            }
          },
          "compliance_pack_keys": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "evidence_obligations": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleObligation"
            }
          },
          "audit_obligations": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleObligation"
            }
          },
          "retention_obligations": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleObligation"
            }
          },
          "explanation_obligations": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleExplanationObligation"
            }
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "LifecycleDefinitionPublishRequest": {
        "type": "object",
        "required": [
          "expected_version",
          "effective_from",
          "validation_receipt_id",
          "canonical_request_hash"
        ],
        "properties": {
          "expected_version": {
            "type": "integer",
            "minimum": 1
          },
          "effective_from": {
            "type": "string",
            "format": "date-time"
          },
          "validation_receipt_id": {
            "type": "string",
            "x-axiom-identifier-classification": "validation-receipt-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "canonical_request_hash": {
            "type": "string",
            "pattern": "^sha256:[a-f0-9]{64}$"
          }
        },
        "additionalProperties": false
      },
      "LifecycleDefinitionResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/LifecycleDefinition"
          }
        },
        "additionalProperties": false
      },
      "LifecycleDefinitionValidationRequest": {
        "type": "object",
        "required": [
          "definition"
        ],
        "properties": {
          "definition": {
            "$ref": "#/components/schemas/LifecycleDefinitionDraftRequest"
          }
        },
        "additionalProperties": false
      },
      "LifecycleExplanationObligation": {
        "allOf": [
          {
            "$ref": "#/components/schemas/LifecycleObligation"
          },
          {
            "type": "object",
            "required": [
              "audiences"
            ],
            "properties": {
              "audiences": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "string",
                  "enum": [
                    "tenant_operator",
                    "party_in_role",
                    "regulator"
                  ]
                }
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "LifecycleObligation": {
        "type": "object",
        "required": [
          "key",
          "description"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "LifecycleState": {
        "type": "object",
        "required": [
          "key",
          "label"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "terminal": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "LifecycleTransition": {
        "type": "object",
        "required": [
          "key",
          "from",
          "to",
          "actor_authority",
          "evidence_refs",
          "audit_refs",
          "retention_refs",
          "explanation_refs"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "from": {
            "type": "string"
          },
          "to": {
            "type": "string"
          },
          "actor_authority": {
            "type": "array",
            "minItems": 1,
            "items": {
              "$ref": "#/components/schemas/LifecycleActorAuthority"
            }
          },
          "ruleset_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "time_gate_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "evidence_refs": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            }
          },
          "audit_refs": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            }
          },
          "retention_refs": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            }
          },
          "explanation_refs": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "LifecycleValidationFinding": {
        "type": "object",
        "required": [
          "code",
          "severity",
          "message"
        ],
        "properties": {
          "code": {
            "type": "string",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "severity": {
            "type": "string",
            "enum": [
              "error",
              "warning"
            ]
          },
          "message": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "LifecycleValidationResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "accepted",
              "canonical_request_hash",
              "findings"
            ],
            "properties": {
              "accepted": {
                "type": "boolean"
              },
              "canonical_request_hash": {
                "type": "string",
                "pattern": "^sha256:[a-f0-9]{64}$"
              },
              "findings": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/LifecycleValidationFinding"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "LineageNode": {
        "type": "object",
        "required": [
          "entry_id",
          "original_entry_id",
          "reversal_entry_id",
          "actor_type",
          "actor_id",
          "actor_original_id",
          "reason_code",
          "content_hash",
          "business_event_time"
        ],
        "properties": {
          "entry_id": {
            "type": "string",
            "example": "orig-http-1",
            "x-axiom-identifier-classification": "ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "original_entry_id": {
            "type": "string",
            "example": "orig-http-1",
            "x-axiom-identifier-classification": "ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "reversal_entry_id": {
            "type": "string",
            "example": "rev-http-1",
            "x-axiom-identifier-classification": "ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_type": {
            "type": "string",
            "example": "human"
          },
          "actor_id": {
            "type": "string",
            "example": "user-1",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "example": "user-1",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "reason_code": {
            "type": "string",
            "example": "correction"
          },
          "content_hash": {
            "type": "string",
            "example": "2f1c0b6e2c8a..."
          },
          "business_event_time": {
            "type": "string",
            "format": "date-time",
            "example": "2026-04-01T09:10:00Z"
          }
        },
        "additionalProperties": false
      },
      "Money": {
        "type": "object",
        "required": [
          "amount_minor",
          "currency_code"
        ],
        "properties": {
          "amount_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Monetary amount in exact integer minor units (e.g. cents for ZAR/USD/EUR). Never float. The minor-unit exponent derives from currency_code \u2014 never hardcoded.",
            "example": 123456
          },
          "currency_code": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO-4217 currency code (e.g. \"zar\"). Must be non-empty; absent currency is a caller error.",
            "example": "zar"
          }
        },
        "additionalProperties": false
      },
      "OwnFamilySummary": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "party_id",
          "families",
          "projection",
          "relationship_predicate"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "families": {
            "type": "array",
            "maxItems": 32,
            "items": {
              "$ref": "#/components/schemas/FamilySummary"
            }
          },
          "projection": {
            "type": "string",
            "const": "summary"
          },
          "relationship_predicate": {
            "type": "string",
            "const": "family_anchor.v1"
          }
        }
      },
      "OwnFamilySummaryResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data"
            ],
            "properties": {
              "data": {
                "$ref": "#/components/schemas/OwnFamilySummary"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "PackVersionRef": {
        "type": "object",
        "properties": {
          "pack_id": {
            "type": "string",
            "description": "Compliance pack UUID",
            "x-axiom-identifier-classification": "compliance-pack-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "pack_version": {
            "type": "string",
            "description": "Semantic version of the pack",
            "example": "1.0.0"
          },
          "ruleset_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Optional typed-prefix ruleset identifier.",
            "example": "rst_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "ruleset-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "ruleset_version": {
            "type": "string",
            "description": "Optional ruleset version"
          }
        },
        "additionalProperties": false
      },
      "PaginationMeta": {
        "type": "object",
        "properties": {
          "next_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cursor for the next page (null if no more pages)",
            "example": "eyJpZCI6MTIwfQ=="
          },
          "prev_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cursor for the previous page when the endpoint supports reverse traversal.",
            "example": "eyJpZCI6OTB9"
          },
          "has_more": {
            "type": "boolean",
            "description": "Whether more pages exist after this one",
            "example": true
          },
          "page_size": {
            "type": "integer",
            "description": "Number of items in this page",
            "example": 20
          },
          "total_count": {
            "type": "integer",
            "description": "Total number of items matching the query.\nMay be omitted for performance on large datasets.\nWhen omitted, use `has_more` to determine if more pages exist.\n",
            "example": 150
          }
        },
        "additionalProperties": false
      },
      "Party": {
        "type": "object",
        "required": [
          "display_name",
          "id",
          "party_type",
          "status",
          "source_system",
          "attributes",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "display_name": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "pattern": "\\S",
            "description": "Tenant-supplied display label, independent of legal-name attributes. Null means no name supplied. Omit on update to preserve the saved value; explicit null clears it. Changes are versioned for as-was replay.",
            "example": "Cedar Engineering (Pty) Ltd"
          },
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "readOnly": true,
            "description": "Unique party identifier",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_type": {
            "type": "string",
            "enum": [
              "individual",
              "organization",
              "system"
            ],
            "description": "Identity classification of the party. Contextual participation such as\nbroker, provider, agent, adjuster, or assessor belongs to PartyRole.role_type,\nnot Party.party_type.\n- individual: A natural person (policyholder role, asserting party role, beneficiary role)\n- organization: A legal entity (corporate client, reinsurer)\n- system: A non-human system identity used for platform mechanics\n",
            "example": "individual"
          },
          "status": {
            "$ref": "#/components/schemas/PartyLifecycleStatus"
          },
          "merged_into_party_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id",
            "description": "Surviving Party identifier when status is merged. Required for status=merged; absent for every other status.",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f2"
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tenant-scoped identifier from the declared source system. Treat as PII-like; do not log raw request bodies containing it.",
            "example": "BRK-000123"
          },
          "source_system": {
            "$ref": "#/components/schemas/PartyExternalIDSourceSystem"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Extensible key-value pairs for party-specific data (name, date of birth, tax ID, etc.)",
            "example": {
              "first_name": "Maria",
              "last_name": "Eriksson",
              "date_of_birth": "1985-03-14",
              "email": "maria.eriksson@example.com"
            }
          },
          "roles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/PartyRole"
            },
            "description": "Roles assigned to this party across policies and retained claim-family compatibility resources"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the party was created",
            "example": "2026-01-15T09:30:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the party was last updated",
            "example": "2026-02-20T14:45:00Z"
          }
        },
        "additionalProperties": false
      },
      "PartyAuditEventItem": {
        "type": "object",
        "required": [
          "id",
          "table_name",
          "operation",
          "performed_at",
          "actor_type",
          "actor_id",
          "actor_original_id",
          "rule_versions",
          "summary"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^aud_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "aud_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "audit-log-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "table_name": {
            "type": "string"
          },
          "operation": {
            "type": "string"
          },
          "old_values": {
            "type": "object",
            "additionalProperties": true
          },
          "new_values": {
            "type": "object",
            "additionalProperties": true
          },
          "user_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "performed_at": {
            "type": "string",
            "format": "date-time"
          },
          "correlation_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "actor_type": {
            "type": "string",
            "enum": [
              "human",
              "service",
              "agent"
            ]
          },
          "actor_id": {
            "type": "string",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "outcome": {
            "type": "string"
          },
          "decision_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "operation_code": {
            "type": "string"
          },
          "purpose": {
            "type": "string",
            "description": "Declared business or compliance purpose recorded with the audit event."
          },
          "compliance_category": {
            "type": "string",
            "description": "Compliance classification attached to the audit event."
          },
          "data_classification": {
            "type": "string",
            "description": "Data classification for the audited payload or access."
          },
          "additional_context": {
            "type": "object",
            "additionalProperties": true,
            "description": "Additional tenant/runtime context captured for the audit event."
          },
          "rule_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "inputs": {
            "type": "object",
            "additionalProperties": true
          },
          "summary": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "PartyAuditListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyAuditEventItem"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data",
              "meta"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyBalanceExplanation": {
        "type": "object",
        "required": [
          "inputs",
          "rule_version",
          "computation",
          "entry_ids"
        ],
        "properties": {
          "inputs": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "rule_version": {
            "type": "string"
          },
          "computation": {
            "type": "string"
          },
          "entry_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "PartyBalanceFilter": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id"
          },
          "policy_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id"
          },
          "cover_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id"
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "role": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "PartyBalanceResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyBalanceResult"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyBalanceResult": {
        "type": "object",
        "required": [
          "party_id",
          "as_of",
          "currency",
          "amount",
          "entry_count"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "currency": {
            "type": "string",
            "pattern": "^[A-Z]{3}$"
          },
          "amount": {
            "type": "string",
            "description": "Decimal amount rendered as a string to preserve exact wire fidelity.",
            "x-axiom-money-classification": "decimal-string-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "entry_count": {
            "type": "integer",
            "minimum": 0
          },
          "filters": {
            "$ref": "#/components/schemas/PartyBalanceFilter"
          },
          "explanation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PartyBalanceExplanation"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false
      },
      "PartyContactItem": {
        "type": "object",
        "required": [
          "id",
          "party_id",
          "contact_type",
          "is_primary",
          "is_active",
          "contact_data"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "contact_type": {
            "type": "string",
            "enum": [
              "email",
              "phone",
              "address",
              "social"
            ]
          },
          "contact_subtype": {
            "type": "string"
          },
          "is_primary": {
            "type": "boolean"
          },
          "is_active": {
            "type": "boolean"
          },
          "contact_data": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-schema governed contact data for the stored contact type."
          },
          "verified_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "PartyContactListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyContactItem"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyContactResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyContactItem"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyDistributionChainResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "description": "Distribution chain traversal result",
                "required": [
                  "participants"
                ],
                "properties": {
                  "participants": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "party_id",
                        "depth",
                        "path"
                      ],
                      "properties": {
                        "party_id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "pty_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "party-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "depth": {
                          "type": "integer"
                        },
                        "relationship_id": {
                          "type": "string",
                          "format": "typed-prefix-id",
                          "pattern": "^rsh_[0-9a-hjkmnp-tv-z]{26}$",
                          "example": "rsh_01arz3ndektsv4rrffq69g5fav",
                          "x-axiom-identifier-classification": "party-relationship-id",
                          "x-axiom-identifier-shape": "typed-prefix"
                        },
                        "relationship_type": {
                          "type": "string"
                        },
                        "path": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "metadata": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true
                        },
                        "selected_path_rank": {
                          "type": "integer"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "explanation": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Traversal reasoning under the governed contract.",
                    "properties": {
                      "as_of": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "start_party_id": {
                        "type": "string",
                        "format": "typed-prefix-id",
                        "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
                        "example": "pty_01arz3ndektsv4rrffq69g5fav",
                        "x-axiom-identifier-classification": "party-id",
                        "x-axiom-identifier-shape": "typed-prefix"
                      },
                      "filters": {
                        "type": "object",
                        "properties": {
                          "as_of": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "types": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "max_depth": {
                            "type": "integer"
                          }
                        },
                        "additionalProperties": false
                      },
                      "candidate_paths": {
                        "type": "array",
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "winning_path": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyExternalIDSourceSystem": {
        "type": "string",
        "enum": [
          "unmapped",
          "kelevra_native",
          "broker_crm",
          "underwriter_pas"
        ],
        "description": "Authoritative alpha registry for Party external identifier provenance.\n`external_id` and `source_system` form an exact lookup pair: callers must supply both or neither on list filters, and create/update must include source_system whenever external_id is supplied.\n",
        "example": "broker_crm"
      },
      "PartyGroup": {
        "type": "object",
        "required": [
          "id",
          "group_type",
          "status",
          "id_namespace",
          "display_name",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique party-group identifier",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "group_type": {
            "type": "string",
            "enum": [
              "static",
              "dynamic"
            ],
            "description": "Membership resolution strategy.\n- static: members are managed manually via the /members endpoints\n- dynamic: members resolve via a CEL rule referenced by membership_rule;\n  on-demand evaluation via POST /evaluate\n",
            "example": "static"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Lifecycle status. Soft delete flips to inactive \u2014 the group and its\nmemberships are preserved for audit (governed contract).\n",
            "example": "active"
          },
          "id_namespace": {
            "type": "string",
            "description": "Namespace for external_id (DEFAULT tenant)",
            "example": "tenant"
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional tenant-supplied identifier, unique per (tenant, id_namespace, group_type)",
            "example": "acme-employees"
          },
          "display_name": {
            "type": "string",
            "description": "Human-readable group name",
            "example": "ACME Employees"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Free-form purpose / semantics",
            "example": "All employees of ACME Corp as of the current payroll run"
          },
          "membership_rule": {
            "type": [
              "object",
              "null"
            ],
            "description": "CEL rule reference for dynamic groups. Shape is `{\"rule_id\": \"...\"}`\nreferencing a rule in the shared rules catalog. MUST be null when\ngroup_type = static; MUST be non-null when group_type = dynamic.\n",
            "additionalProperties": true,
            "example": {
              "rule_id": "rule-party-age-over-18"
            }
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "example": "2026-04-18T09:30:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "example": "2026-04-18T09:30:00Z"
          },
          "created_by_actor_type": {
            "type": "string",
            "readOnly": true,
            "description": "Actor attribution under the governed contract",
            "example": "human"
          },
          "created_by_actor_id": {
            "type": "string",
            "readOnly": true,
            "example": "user-marcus@acme.example",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "PartyGroupAuditEntry": {
        "type": "object",
        "required": [
          "id",
          "table_name",
          "operation",
          "performed_at",
          "actor_type",
          "actor_id",
          "actor_original_id",
          "rule_versions",
          "summary"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^aud_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "aud_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "audit-log-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "table_name": {
            "type": "string"
          },
          "operation": {
            "type": "string"
          },
          "old_values": {
            "type": "object",
            "additionalProperties": true
          },
          "new_values": {
            "type": "object",
            "additionalProperties": true
          },
          "user_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "performed_at": {
            "type": "string",
            "format": "date-time"
          },
          "correlation_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "actor_type": {
            "type": "string",
            "enum": [
              "human",
              "service",
              "agent"
            ]
          },
          "actor_id": {
            "type": "string",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "outcome": {
            "type": "string"
          },
          "decision_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "operation_code": {
            "type": "string"
          },
          "rule_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "inputs": {
            "type": "object",
            "additionalProperties": true
          },
          "summary": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "PartyGroupAuditListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyGroupAuditEntry"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data",
              "meta"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupDetail": {
        "type": "object",
        "required": [
          "party_group",
          "members"
        ],
        "properties": {
          "party_group": {
            "$ref": "#/components/schemas/PartyGroup"
          },
          "members": {
            "type": "array",
            "description": "Active memberships as of the query time (or ?as_of=)",
            "items": {
              "$ref": "#/components/schemas/PartyGroupMembership"
            }
          }
        },
        "additionalProperties": false
      },
      "PartyGroupDetailResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyGroupDetail"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupEvaluationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyGroupEvaluationResult"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupEvaluationResult": {
        "type": "object",
        "required": [
          "group_id",
          "party_id",
          "is_member",
          "evaluated_at"
        ],
        "description": "Read-only dry-run result of evaluating a dynamic group's membership rule\nagainst a candidate party. Does NOT mutate state.\n",
        "properties": {
          "group_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "is_member": {
            "type": "boolean",
            "description": "Whether the rule accepts this party for this group"
          },
          "rule_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed-prefix identifier for the rule that was evaluated."
          },
          "rule_type": {
            "type": [
              "string",
              "null"
            ],
            "example": "party_grouping"
          },
          "evaluated_at": {
            "type": "string",
            "format": "date-time"
          },
          "explanation_summary": {
            "type": "string",
            "description": "under the governed contract \u2014 concise trace of which clauses matched or failed",
            "example": "party_type == individual: matched; attributes.age >= 18: matched"
          }
        },
        "additionalProperties": false
      },
      "PartyGroupFlatMember": {
        "type": "object",
        "required": [
          "party_id",
          "found_at_depth"
        ],
        "description": "One party reachable from a group via recursive membership expansion",
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "found_at_depth": {
            "type": "integer",
            "minimum": 1,
            "description": "BFS depth at which this party was first reached (1 = direct member)"
          },
          "via_path": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Chain of group ids from the start group to this party"
          },
          "membership_id": {
            "type": "string",
            "description": "The membership row that connected this party at the first depth found",
            "format": "typed-prefix-id",
            "pattern": "^pgm_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgm_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-membership-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "valid_from": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "PartyGroupFlatMemberListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyGroupFlatMember"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyGroup"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupMembership": {
        "type": "object",
        "required": [
          "id",
          "group_id",
          "member_type",
          "member_id",
          "valid_from",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "format": "typed-prefix-id",
            "pattern": "^pgm_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgm_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-membership-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "group_id": {
            "type": "string",
            "description": "FK to party_groups.id",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "member_type": {
            "type": "string",
            "enum": [
              "party",
              "group"
            ],
            "description": "Polymorphic member kind. `party` means member_id references parties.id;\n`group` means member_id references party_groups.id (nested membership).\n",
            "example": "party"
          },
          "member_id": {
            "type": "string",
            "description": "FK to parties.id OR party_groups.id per member_type",
            "format": "typed-prefix-id",
            "example": "ref_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Membership start (inclusive)",
            "example": "2026-04-18T09:30:00Z"
          },
          "valid_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Membership end (exclusive); null = currently active"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "created_by_actor_type": {
            "type": "string",
            "readOnly": true
          },
          "created_by_actor_id": {
            "type": "string",
            "readOnly": true,
            "format": "typed-prefix-id",
            "pattern": "^act_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "act_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "PartyGroupMembershipResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyGroupMembership"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupMembershipView": {
        "type": "object",
        "required": [
          "group_id",
          "name",
          "grouping_rule_id",
          "effective_from",
          "via_policy_id"
        ],
        "properties": {
          "group_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "name": {
            "type": "string"
          },
          "grouping_rule_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed-prefix identifier for the group membership rule.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "effective_from": {
            "type": "string",
            "format": "date-time"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true
          },
          "via_policy_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "PartyGroupResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyGroup"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupRole": {
        "type": "object",
        "required": [
          "id",
          "role_type",
          "context",
          "effective_from"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "format": "typed-prefix-id",
            "pattern": "^rol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "rol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-role-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "role_type": {
            "type": "string",
            "enum": [
              "sponsor",
              "provider",
              "beneficiary",
              "accepted_provider_network"
            ],
            "description": "Role played by the group.\n- sponsor: Group sponsoring a scheme (e.g. employer on a group health policy)\n- provider: Group acting as a service provider\n- beneficiary: Group entitled to benefits\n- accepted_provider_network: Provider-network group accepted on a Product context. Requires composition_type=provider_network on the assignee group and\n  entity_type=product on the role context.\n",
            "example": "sponsor"
          },
          "context": {
            "type": "object",
            "required": [
              "entity_type",
              "entity_id"
            ],
            "description": "Entity the role is held against (policy, retained claim-family compatibility resource, party, etc.)",
            "properties": {
              "entity_type": {
                "type": "string",
                "example": "policy"
              },
              "entity_id": {
                "type": "string",
                "example": "ref_01arz3ndektsv4rrffq69g5fav",
                "format": "typed-prefix-id",
                "x-axiom-identifier-classification": "typed-prefix-wire-id",
                "x-axiom-identifier-shape": "typed-prefix"
              }
            },
            "additionalProperties": false
          },
          "effective_from": {
            "type": "string",
            "format": "date-time",
            "example": "2026-04-18T09:30:00Z"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "revoked_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "revocation_reason": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "PartyGroupRoleListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyGroupRole"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyGroupRoleResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyGroupRole"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyHistoryResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyHistoryVersion"
                }
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "PartyHistoryVersion": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "row_id",
          "valid_from",
          "valid_to",
          "asserted_from",
          "asserted_to",
          "recorded_at",
          "supersedes",
          "reversed_by",
          "replay"
        ],
        "properties": {
          "row_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^ptv_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Immutable party history row identity.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Inclusive validity lower bound at stored precision."
          },
          "valid_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Exclusive validity upper bound; null means unbounded."
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "Inclusive belief lower bound at stored precision."
          },
          "asserted_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Exclusive belief upper bound; null means unbounded."
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "Immutable physical recording anchor."
          },
          "supersedes": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id",
            "pattern": "^ptv_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Predecessor history row, when present."
          },
          "reversed_by": {
            "type": [
              "string",
              "null"
            ],
            "format": "typed-prefix-id",
            "pattern": "^ptv_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Reversal chain reference, when present; not a reversal timestamp."
          },
          "replay": {
            "type": [
              "object",
              "null"
            ],
            "description": "Exact reproducible coordinates; null when stored evidence cannot establish a replayable window. Preserve timestamp strings without rounding or offsets.",
            "additionalProperties": false,
            "required": [
              "as_of",
              "recorded_at"
            ],
            "properties": {
              "as_of": {
                "type": "string",
                "format": "date-time",
                "description": "Exact valid_from coordinate."
              },
              "recorded_at": {
                "type": "string",
                "format": "date-time",
                "description": "Exact asserted_from coordinate for the existing GET replay API."
              }
            }
          }
        }
      },
      "PartyIdentityItem": {
        "type": "object",
        "required": [
          "id",
          "party_id",
          "identity_type",
          "verification_status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "idn_01J9ZXKP8WQRM2N4V6T5S3D7F5",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "identity_type": {
            "type": "string"
          },
          "identity_number": {
            "type": "string"
          },
          "issuing_authority": {
            "type": "string"
          },
          "issued_at": {
            "type": "string",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "identity_data": {
            "type": "object",
            "additionalProperties": true
          },
          "verification_status": {
            "type": "string",
            "description": "Verification status from the tenant catalogue; newly captured identities are pending."
          },
          "verified_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "PartyIdentityListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyIdentityItem"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyIdentityResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyIdentityItem"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyLifecycleStatus": {
        "type": "string",
        "enum": [
          "active",
          "inactive",
          "suspended",
          "deceased",
          "merged",
          "opted_out"
        ],
        "description": "Current Party lifecycle status.\n- active: Party can participate in transactions.\n- inactive: Party is no longer active.\n- suspended: Party is temporarily suspended pending review.\n- deceased: Natural-person Party is terminally deceased.\n- merged: Duplicate Party has been merged into merged_into_party_id and rejects later Party-scoped mutations.\n- opted_out: Party has opted out of new contact capture; historical contact reads remain available.\n",
        "example": "active"
      },
      "PartyListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Party"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyPaymentListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Payment"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyPolicyGroupListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyGroupMembershipView"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyRelationshipItem": {
        "type": "object",
        "description": "Relationship resource per parties.RelationshipResponse",
        "required": [
          "id",
          "from_party_id",
          "to_party_id",
          "relationship_type",
          "effective_from",
          "created_by"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "ptr_01J9ZXKP8WQRM2N4V6T5S3D7F6",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "from_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "to_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f2",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "relationship_type": {
            "type": "string",
            "description": "Tenant `catalogue.relationship_types` code."
          },
          "effective_from": {
            "type": "string",
            "format": "date-time"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "created_by": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "PartyRelationshipListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyRelationshipItem"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyRelationshipResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyRelationshipItem"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Party"
              },
              "meta": {
                "$ref": "#/components/schemas/WorkbenchEditReceiptMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyRole": {
        "type": "object",
        "required": [
          "id",
          "role_type",
          "context",
          "status",
          "assigned_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "readOnly": true,
            "description": "Unique role assignment identifier",
            "example": "rol_01j9zxkp8wqrm2n4v6t5s3d7f3",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "role_type": {
            "type": "string",
            "description": "Tenant `catalogue.role_types` code assigned to the party. Bootstrap\nseed codes include policyholder, insured, beneficiary, broker, sponsor,\nand accepted_provider_network, but tenants may govern additional role\ntypes through the catalogue.\n",
            "example": "policyholder"
          },
          "context": {
            "$ref": "#/components/schemas/RoleContext"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Whether this role assignment is currently active",
            "example": "active"
          },
          "assigned_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the role was assigned",
            "example": "2026-01-15T09:30:00Z"
          }
        },
        "additionalProperties": false
      },
      "PartyRoleListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyRole"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyRoleResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PartyRole"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyRoleRevocationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "role_id"
                ],
                "properties": {
                  "role_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "description": "Revoked role assignment identifier.",
                    "x-axiom-identifier-shape": "typed-prefix"
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PartyRoleTypeEntry": {
        "type": "object",
        "required": [
          "code",
          "display_name",
          "universal",
          "assignable_context_types",
          "requires_attribution"
        ],
        "properties": {
          "code": {
            "type": "string",
            "description": "Wire-stable party role type code.",
            "example": "policyholder",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "display_name": {
            "type": "string",
            "description": "Human-readable role type label.",
            "example": "Policyholder"
          },
          "universal": {
            "type": "boolean",
            "description": "True when the role type is universal across tenants.",
            "example": true
          },
          "assignable_context_types": {
            "type": [
              "array",
              "null"
            ],
            "description": "Context types where this role type may be assigned.",
            "items": {
              "type": "string"
            },
            "example": [
              "policy",
              "policy_item"
            ]
          },
          "requires_attribution": {
            "type": "boolean",
            "description": "True when the role assignment requires actor attribution.",
            "example": true
          },
          "regulatory_category": {
            "type": "string",
            "description": "Regulatory designation when one applies.",
            "example": "FAIS representative"
          },
          "sector_hint": {
            "type": "string",
            "description": "Sector context for non-universal role types.",
            "example": "health"
          }
        },
        "additionalProperties": false
      },
      "PayClaimRequest": {
        "type": "object",
        "required": [
          "paid_amount",
          "payment_method"
        ],
        "properties": {
          "paid_amount": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Amount to disburse (exact integer minor units + lowercase ISO-4217 currency code). Must be non-empty."
          },
          "payment_method": {
            "type": "string",
            "description": "Payment disbursement method",
            "example": "bank_transfer"
          },
          "payment_notes": {
            "type": [
              "string",
              "null"
            ],
            "description": "Notes accompanying the payment",
            "example": "Final settlement \u2014 retained assertion fully resolved"
          },
          "authorisation_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "governed contract authorisation row to cite and gate before payment.",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01"
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Operational metadata for the payment",
            "example": {
              "bank_reference": "JPMC-ACH-2026030801",
              "beneficiary_account": "****4521"
            }
          }
        },
        "additionalProperties": false
      },
      "PayClaimResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ClaimPayment"
              },
              "ledger_entries": {
                "type": "array",
                "description": "Durable balanced ledger entries created by the claim payment. Each entry_id can be used with the ledger reversal endpoint.",
                "items": {
                  "$ref": "#/components/schemas/ClaimPaymentLedgerEntry"
                }
              }
            },
            "required": [
              "data",
              "ledger_entries"
            ],
            "additionalProperties": true
          }
        ]
      },
      "Payment": {
        "type": "object",
        "required": [
          "id",
          "amount",
          "status",
          "payment_method",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique payment identifier",
            "readOnly": true,
            "example": "pay_20260403_0001",
            "x-axiom-identifier-classification": "payment-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "amount": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Payment amount (exact integer minor units + lowercase ISO-4217 currency code)."
          },
          "status": {
            "$ref": "#/components/schemas/PaymentStatus"
          },
          "payment_method": {
            "$ref": "#/components/schemas/PaymentMethod"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-readable description of the payment purpose",
            "example": "Monthly premium \u2014 motor comprehensive policy POL-2026-00123"
          },
          "reference_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reference to the associated resource (premium, retained claim-family compatibility resource, etc.)",
            "example": "pay_20260403_0001"
          },
          "reference_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Type of the referenced resource (for example premium, retained claim-family compatibility resource, or refund)",
            "example": "premium"
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible key-value metadata for integration and operational data",
            "example": {
              "bank_reference": "ABSA-EFT-20260401-0042",
              "batch_id": "BATCH-2026-04-01",
              "reconciliation_status": "matched"
            }
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the payment record was created",
            "readOnly": true,
            "example": "2026-04-01T06:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the payment record was last updated",
            "readOnly": true,
            "example": "2026-04-01T08:30:00Z"
          },
          "processed_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Timestamp when the payment was successfully processed (null if not yet processed)",
            "readOnly": true,
            "example": "2026-04-01T08:30:00Z"
          },
          "party_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reference to the party (policyholder, beneficiary, etc.) associated with this payment. Nullable for backward compatibility with payments created before party linkage.",
            "example": "pay_20260403_0001"
          }
        },
        "additionalProperties": false
      },
      "PaymentListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Payment"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PaymentMethod": {
        "type": "string",
        "enum": [
          "bank_transfer",
          "credit_card",
          "debit_order",
          "cash",
          "cheque"
        ],
        "description": "Supported payment methods:\n- `bank_transfer` \u2014 Electronic funds transfer (EFT) or wire transfer\n- `credit_card` \u2014 Credit card payment via payment gateway\n- `debit_order` \u2014 Recurring debit order (direct debit) from bank account\n- `cash` \u2014 Cash payment (recorded manually, typically at branch)\n- `cheque` \u2014 Cheque payment (subject to clearing period)\n",
        "example": "debit_order"
      },
      "PaymentResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Payment"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PaymentStatus": {
        "type": "string",
        "enum": [
          "pending",
          "completed",
          "cancelled"
        ],
        "description": "Payment lifecycle status. This public lifecycle is the Axiom payment command\nlifecycle implemented by the Payment service, not the provider outcome\nvocabulary used internally by Billing/Invoicing traces.\n- `pending` \u2014 Payment has been created and may still be updated, processed, or cancelled.\n- `completed` \u2014 Payment reached the successful terminal state.\n- `cancelled` \u2014 Payment was cancelled before completion.\n",
        "example": "pending"
      },
      "Policy": {
        "type": "object",
        "required": [
          "id",
          "policy_number",
          "product_id",
          "status",
          "effective_date",
          "expiry_date",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "readOnly": true,
            "description": "Unique policy identifier",
            "example": "pol_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_number": {
            "type": "string",
            "readOnly": true,
            "description": "Human-readable policy number assigned by the system",
            "example": "POL-2026-000142"
          },
          "external_id": {
            "type": "string",
            "description": "Optional caller-supplied external identifier carried as canonical policy identity",
            "example": "seed-pol-CM-GAP-00001",
            "x-axiom-identifier-classification": "tenant-external-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "is_seed_principal": {
            "type": "boolean",
            "description": "Marks a policy created by sanctioned seed/fixture ingestion",
            "example": true
          },
          "product_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Identifier of the product this policy is issued under",
            "example": "prd_01abcdefghjkmnpqrstvwxyz01",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "quoted",
              "bound",
              "active",
              "lapsed",
              "cancelled",
              "expired"
            ],
            "description": "Current status of the policy. The policy lifecycle follows this state machine:\n\n```\nquoted -> draft -> bound -> active -> cancelled|lapsed|expired\n```\n\nTransitions:\n- `quoted` -> `draft`: A quote or proposal has been accepted for policy preparation.\n- `draft` -> `bound`: The policy has been reviewed and contractually bound.\n- `bound` -> `active`: The policy has reached its effective date and is providing coverage.\n- `active` -> `cancelled`: Coverage ended before natural expiry.\n- `active` -> `lapsed`: Coverage ended due to non-payment.\n- `active` -> `expired`: Coverage ended at natural expiry.\n\nInvalid transitions return HTTP 422 with error code `INVALID_STATE_TRANSITION`.\n\nPer-value descriptions:\n- `draft`: Policy is being prepared; not yet formally issued or providing coverage\n- `quoted`: Policy proposal exists before contractual binding\n- `bound`: Policy has been contractually bound but is not necessarily active\n- `active`: Policy is in force and providing coverage to the insured parties\n- `lapsed`: Policy coverage ended due to non-payment\n- `cancelled`: Policy coverage ended before natural expiry\n- `expired`: Policy coverage ended at natural expiry\n",
            "example": "active"
          },
          "effective_date": {
            "type": "string",
            "format": "date",
            "description": "Date from which the policy provides coverage (inclusive)",
            "example": "2026-03-01"
          },
          "expiry_date": {
            "type": "string",
            "format": "date",
            "description": "Date on which the policy coverage ends (inclusive)",
            "example": "2027-02-28"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible key-value pairs for policy-specific data",
            "example": {
              "sum_insured": 250000,
              "territory": "EU",
              "renewal_count": 0
            }
          },
          "parties": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/PolicyPartyRole"
            },
            "description": "Parties and their roles on this policy"
          },
          "premiums": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/PolicyPremiumScheduleItem"
            },
            "description": "Premium schedule for this policy"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the policy was created",
            "example": "2026-02-28T11:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the policy was last updated",
            "example": "2026-03-01T09:15:00Z"
          }
        },
        "additionalProperties": false
      },
      "PolicyBindRequest": {
        "type": "object",
        "required": [
          "parties",
          "payment_method",
          "bound_by"
        ],
        "description": "Two bind modes: (1) quote-backed \u2014 provide quote_id; or (2) inline \u2014 provide product_id, effective_date, and expiry_date. parties, payment_method, and bound_by are always required.",
        "properties": {
          "quote_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Quote identifier for quote-backed bind. Mutually exclusive with inline fields (product_id, effective_date, expiry_date).",
            "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "qte_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "quote-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "product_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Product identifier for inline bind. Required when quote_id is not provided.",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "effective_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 timestamp for policy activation. Required for inline bind (when quote_id is not provided)."
          },
          "expiry_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 timestamp for policy expiry. Required for inline bind (when quote_id is not provided)."
          },
          "underwriting_data": {
            "type": "object",
            "additionalProperties": true
          },
          "parties": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "required": [
                "party_id",
                "role"
              ],
              "properties": {
                "party_id": {
                  "type": "string",
                  "format": "typed-prefix-id",
                  "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
                  "example": "pty_01arz3ndektsv4rrffq69g5fav",
                  "x-axiom-identifier-classification": "party-id",
                  "x-axiom-identifier-shape": "typed-prefix"
                },
                "role": {
                  "type": "string",
                  "enum": [
                    "policyholder",
                    "dependent",
                    "insured",
                    "beneficiary",
                    "agent",
                    "broker"
                  ]
                }
              },
              "additionalProperties": false
            }
          },
          "payment_method": {
            "type": "string"
          },
          "bound_by": {
            "type": "string"
          },
          "binding_mode": {
            "type": "string",
            "enum": [
              "individual",
              "group"
            ],
            "default": "individual",
            "description": "Policy binding mode. Defaults to \"individual\" for backward compatibility. Set to \"group\" for master policy inception."
          },
          "group_context": {
            "type": [
              "object",
              "null"
            ],
            "description": "Required when binding_mode=group; must be absent for individual.",
            "properties": {
              "group_type": {
                "type": "string",
                "enum": [
                  "family",
                  "employer"
                ]
              },
              "group_name": {
                "type": "string"
              },
              "external_group_ref": {
                "type": "string"
              }
            }
          }
        },
        "additionalProperties": false
      },
      "PolicyBindResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PolicyBindResult"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PolicyBindResult": {
        "type": "object",
        "description": "The bound-policy payload returned in the SuccessEnvelope data field.",
        "required": [
          "policy_id",
          "policy_number",
          "status",
          "premium_breakdown",
          "bound_at",
          "premium_id"
        ],
        "properties": {
          "policy_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_number": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "active"
            ]
          },
          "premium_breakdown": {
            "type": "object",
            "additionalProperties": true
          },
          "bound_at": {
            "type": "string",
            "format": "date-time"
          },
          "premium_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "ID of the premium record created during bind (governed contract). Always present on success.",
            "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "prm_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "premium-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "explanation_tree_id": {
            "type": "string",
            "description": "ID of the bind explanation tree (governed contract), when produced.",
            "x-axiom-identifier-classification": "explanation-tree-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "ledger_entry_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "typed-prefix-id"
            },
            "description": "Ledger entry IDs produced during bind, when applicable."
          }
        },
        "additionalProperties": false
      },
      "PolicyEndorsement": {
        "type": "object",
        "required": [
          "id",
          "policy_id",
          "endorsement_number",
          "type",
          "description",
          "effective_date",
          "status",
          "endorsed_by",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "readOnly": true,
            "description": "Policy-version identifier for this endorsement snapshot",
            "example": "pov_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Identifier of the policy being endorsed",
            "example": "pol_01abcdefghjkmnpqrstvwxyz01",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "endorsement_number": {
            "type": "string",
            "readOnly": true,
            "description": "Sequential endorsement number within the policy",
            "example": "END-001"
          },
          "type": {
            "type": "string",
            "description": "Classification of the endorsement (e.g. amendment, addition, deletion, correction)",
            "example": "amendment",
            "x-axiom-coded-value-classification": "tenant-catalogue-type"
          },
          "description": {
            "type": "string",
            "description": "Human-readable description of what this endorsement changes",
            "example": "Update insured address and increase sum insured from 250,000 to 300,000"
          },
          "effective_date": {
            "type": "string",
            "format": "date",
            "description": "Date from which the endorsement takes effect",
            "example": "2026-06-01"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "applied",
              "rejected"
            ],
            "description": "Processing status of the endorsement.\n- pending: Endorsement has been submitted but not yet applied\n- applied: Endorsement has been applied to the policy\n- rejected: Endorsement was rejected (e.g. failed validation)\n",
            "example": "applied"
          },
          "changes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Structured representation of the changes made by this endorsement",
            "example": {
              "sum_insured": {
                "from": 250000,
                "to": 300000
              },
              "address": {
                "from": "10 Downing Street, London",
                "to": "221B Baker Street, London"
              }
            }
          },
          "endorsed_by": {
            "type": "string",
            "description": "Identifier of the user or process that created this endorsement",
            "example": "underwriter-user-003"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the endorsement was created",
            "example": "2026-05-28T14:00:00Z"
          }
        },
        "additionalProperties": false
      },
      "PolicyListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Policy"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PolicyPartyRequest": {
        "type": "object",
        "required": [
          "party_id",
          "role"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Identifier of an existing party to assign to the policy",
            "example": "pty_01abcdefghjkmnpqrstvwxyz01",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "role": {
            "type": "string",
            "description": "Role to assign the party on this policy (e.g. policyholder, dependent, insured, beneficiary)",
            "example": "policyholder"
          }
        },
        "additionalProperties": false
      },
      "PolicyPartyRole": {
        "type": "object",
        "required": [
          "party_id",
          "party_type",
          "role",
          "status",
          "assigned_at"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Identifier of the party",
            "example": "pty_01abcdefghjkmnpqrstvwxyz01",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_type": {
            "type": "string",
            "description": "Classification of the party (e.g. individual, organization)",
            "example": "individual"
          },
          "role": {
            "type": "string",
            "enum": [
              "policyholder",
              "dependent",
              "insured",
              "beneficiary",
              "agent",
              "broker"
            ],
            "description": "Role of the party on this policy",
            "example": "policyholder"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive",
              "revoked"
            ],
            "description": "Whether this party-role assignment is currently active or has been revoked",
            "example": "active"
          },
          "assigned_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the party was assigned to this policy",
            "example": "2026-02-28T11:00:00Z"
          }
        },
        "additionalProperties": false
      },
      "PolicyPremiumScheduleItem": {
        "type": "object",
        "required": [
          "id",
          "amount",
          "due_date",
          "status",
          "payment_method"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "readOnly": true,
            "description": "Unique premium instalment identifier",
            "example": "pms_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "description": "Premium amount due for this instalment in the smallest currency unit (e.g. cents). Exact integer representation.",
            "example": 11500,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "due_date": {
            "type": "string",
            "format": "date",
            "description": "Date by which the premium payment is due",
            "example": "2026-04-01"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "paid",
              "overdue",
              "waived"
            ],
            "description": "Payment status of this premium instalment.\n- pending: Payment has not yet been received and is not overdue\n- paid: Payment has been received and reconciled\n- overdue: Payment was not received by the due date\n- waived: Payment has been waived (e.g. goodwill, correction)\n",
            "example": "pending"
          },
          "payment_method": {
            "type": "string",
            "description": "Method of payment (e.g. debit_order, card, bank_transfer, cash)",
            "example": "debit_order"
          }
        },
        "additionalProperties": false
      },
      "PolicyResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Policy"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PolicyVersion": {
        "type": "object",
        "required": [
          "id",
          "policy_id",
          "version_number",
          "version_type",
          "effective_from",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Typed-prefix policy-version identifier (pov_\u2026)",
            "readOnly": true,
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Typed-prefix parent policy identifier (pol_\u2026)",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "version_number": {
            "type": "integer",
            "description": "Sequential version number within the policy",
            "example": 2
          },
          "version_type": {
            "type": "string",
            "enum": [
              "issuance",
              "endorsement",
              "renewal",
              "cancellation"
            ],
            "description": "Why this version was created"
          },
          "effective_from": {
            "type": "string",
            "format": "date-time",
            "description": "When this version becomes effective (inclusive)"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When this version ceases to be effective (null = current version)"
          },
          "change_reason": {
            "type": "string",
            "description": "Human-readable reason for creating this version"
          },
          "created_by": {
            "type": "string",
            "description": "Actor ID who created this version (governed contract)"
          },
          "previous_version": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "ID of the predecessor version (empty for first version)"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the version was created"
          }
        },
        "additionalProperties": false
      },
      "PolicyVersionListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PolicyVersion"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PolicyVersionResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PolicyVersion"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "Premium": {
        "type": "object",
        "required": [
          "id",
          "policy_id",
          "premium_type",
          "status",
          "currency",
          "base_premium",
          "total_discount",
          "total_surcharge",
          "tax_amount",
          "net_premium",
          "final_premium",
          "installment_count",
          "installment_amount_minor",
          "payment_frequency",
          "effective_date",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique premium identifier",
            "readOnly": true,
            "example": "prm_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "premium-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_id": {
            "type": "string",
            "description": "Reference to the policy this premium belongs to, in the canonical\ntyped-prefix form (`pol_\u2026`, governed contract). Not a bare UUID.\n",
            "example": "pol_01h9xg2c7e8f4a5b6c7d8e9f0a",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": "string",
            "description": "Optional reference to the party who owes this premium (the debtor /\npolicyholder), in the canonical typed-prefix form (`pty_\u2026`, governed contract).\nOmitted when unset (absent \u2260 unknown, governed contract).\n",
            "example": "pty_01h9xg2c7e8f4a5b6c7d8e9f0a",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "premium_type": {
            "type": "string",
            "description": "Classifier on the single aggregate premium (NOT a row-multiplier) \u2014 e.g.\n`initial`, `renewal`, `endorsement`, `adjustment` (governed contract). Variation\nis recorded as append-only ledger entries, never a second Premium row.\n",
            "example": "initial"
          },
          "status": {
            "$ref": "#/components/schemas/PremiumStatus"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO-4217 currency code (e.g. \"zar\", governed contract). Interprets every\n`*_minor` money field on this object; the minor-unit exponent is derived\nfrom this code, never hardcoded.\n",
            "example": "zar"
          },
          "base_premium": {
            "type": "integer",
            "format": "int64",
            "description": "Base premium before discounts/surcharges/tax, in exact int64 minor units (governed contract, never float).",
            "example": 125000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "total_discount": {
            "type": "integer",
            "format": "int64",
            "description": "Total discount applied, in exact int64 minor units (governed contract, never float).",
            "example": 0,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "total_surcharge": {
            "type": "integer",
            "format": "int64",
            "description": "Total surcharge applied, in exact int64 minor units (governed contract, never float).",
            "example": 0,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "tax_amount": {
            "type": "integer",
            "format": "int64",
            "description": "Tax component, in exact int64 minor units (governed contract, never float).",
            "example": 0,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "net_premium": {
            "type": "integer",
            "format": "int64",
            "description": "Canonical net premium (base \u2212 discount + surcharge + tax), in exact int64\nminor units (governed contract, never float). This is the canonical net field \u2014 render\nthis as the money headline, never base_premium.\n",
            "example": 125000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "final_premium": {
            "type": "integer",
            "format": "int64",
            "description": "Deprecated alias for net_premium \u2014 same value. Read net_premium\ninstead. Retained for back-compat with the PremiumCalculation shape.\n",
            "example": 125000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "installment_count": {
            "type": "integer",
            "description": "Number of instalments the premium is split into (1 = single payment).",
            "example": 1
          },
          "installment_amount_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Per-instalment amount, in exact int64 minor units (governed contract, never float).",
            "example": 125000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "payment_frequency": {
            "type": "string",
            "description": "Payment cadence for the premium (e.g. `annual`, `monthly`, `quarterly`).",
            "example": "annual"
          },
          "effective_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 timestamp from which the premium obligation is effective.",
            "example": "2026-03-01T00:00:00Z"
          },
          "expiry_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 timestamp at which the premium obligation expires. Omitted when unset.",
            "example": "2027-03-01T00:00:00Z"
          },
          "due_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 timestamp on which the premium is due. Omitted when unset.",
            "example": "2026-04-01T00:00:00Z"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the premium record was created",
            "readOnly": true,
            "example": "2026-03-01T00:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the premium record was last updated",
            "readOnly": true,
            "example": "2026-03-15T10:30:00Z"
          }
        },
        "additionalProperties": false
      },
      "PremiumAdjustment": {
        "type": "object",
        "required": [
          "rule_name",
          "adjustment",
          "description"
        ],
        "properties": {
          "rule_name": {
            "type": "string",
            "description": "Name of the rule that produced this adjustment",
            "example": "young_driver_loading"
          },
          "adjustment": {
            "type": "integer",
            "format": "int64",
            "description": "Adjustment amount in the smallest currency unit (e.g. cents). Positive for loading, negative for discount. Exact integer representation.",
            "example": 7500
          },
          "description": {
            "type": "string",
            "description": "Human-readable explanation of the adjustment",
            "example": "Young driver loading \u2014 primary driver age 21, 15% applied to base premium"
          }
        },
        "additionalProperties": false
      },
      "PremiumCalculation": {
        "type": "object",
        "required": [
          "product_id",
          "base_premium",
          "total_premium",
          "gross_premium",
          "discount_total",
          "net_premium",
          "calculated_at"
        ],
        "properties": {
          "product_id": {
            "type": "string",
            "description": "Reference to the product used for calculation",
            "example": "prm_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "base_premium": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Base premium before adjustments and commissions."
          },
          "total_premium": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Total premium including all adjustments (gross premium)."
          },
          "gross_premium": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Pre-discount premium equal to total_premium. Provided explicitly for discount transparency."
          },
          "discount_total": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Total discount amount composed from all applicable group discounts."
          },
          "net_premium": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Net premium after deducting discounts (gross_premium - discount_total)."
          },
          "adjusted_premium": {
            "type": [
              "object",
              "null"
            ],
            "description": "Legacy alias for gross_premium. Deprecated: use gross_premium instead.",
            "properties": {
              "amount_minor": {
                "type": "integer",
                "format": "int64",
                "example": 57500
              },
              "currency_code": {
                "type": "string",
                "pattern": "^[a-z]{3}$",
                "example": "gbp"
              }
            }
          },
          "final_premium": {
            "type": [
              "object",
              "null"
            ],
            "description": "Legacy alias for net_premium. Deprecated: use net_premium instead.",
            "properties": {
              "amount_minor": {
                "type": "integer",
                "format": "int64",
                "example": 52500
              },
              "currency_code": {
                "type": "string",
                "pattern": "^[a-z]{3}$",
                "example": "gbp"
              }
            }
          },
          "adjustments": {
            "type": [
              "array",
              "null"
            ],
            "description": "Itemised premium adjustments applied during calculation",
            "items": {
              "$ref": "#/components/schemas/PremiumAdjustment"
            }
          },
          "discounts": {
            "type": [
              "array",
              "null"
            ],
            "description": "Itemised group discounts applied to the gross premium",
            "items": {
              "$ref": "#/components/schemas/PremiumDiscountItem"
            }
          },
          "commissions": {
            "type": [
              "array",
              "null"
            ],
            "description": "Commission amounts deducted from the net premium",
            "items": {
              "$ref": "#/components/schemas/CommissionAmount"
            }
          },
          "calculated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the premium was calculated",
            "readOnly": true,
            "example": "2026-03-10T14:00:00Z"
          }
        },
        "additionalProperties": false
      },
      "PremiumCalculationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/PremiumCalculation"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PremiumCollectionLedgerEntry": {
        "type": "object",
        "required": [
          "id",
          "account_code",
          "entry_type",
          "amount",
          "currency",
          "entity_type",
          "entity_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Ledger entry identifier.",
            "x-axiom-identifier-classification": "premium-collection-ledger-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "account_code": {
            "type": "string",
            "description": "Ledger account code used by the collection posting."
          },
          "entry_type": {
            "type": "string",
            "enum": [
              "debit",
              "credit"
            ]
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "description": "Exact integer minor-unit amount. Never float.",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO-4217 currency code."
          },
          "entity_type": {
            "type": "string",
            "description": "Entity type linked to this ledger entry."
          },
          "entity_id": {
            "type": "string",
            "description": "Entity identifier linked to this ledger entry.",
            "x-axiom-identifier-classification": "premium-collection-ledger-entity-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "PremiumDiscountItem": {
        "type": "object",
        "required": [
          "group_id",
          "rule_id",
          "rule_version",
          "amount",
          "composition_included",
          "description"
        ],
        "properties": {
          "group_id": {
            "type": "string",
            "description": "Identifier of the group that triggered this discount",
            "example": "pgr_01arz3ndektsv4rrffq69g5fav",
            "format": "typed-prefix-id",
            "pattern": "^pgr_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "party-group-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "rule_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed-prefix identifier of the discount rule that was evaluated.",
            "example": "rul_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "rule_version": {
            "type": "integer",
            "description": "Version of the discount rule used",
            "example": 1
          },
          "amount": {
            "type": "integer",
            "format": "int64",
            "description": "Discount amount in the smallest currency unit (e.g. cents). Always non-negative. Exact integer representation.",
            "example": 5000,
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "composition_included": {
            "type": "boolean",
            "description": "Whether this discount was included in the composed discount total",
            "example": true
          },
          "description": {
            "type": "string",
            "description": "Human-readable explanation of the discount",
            "example": "Group discount: Family Plan (rule rule-fam-disc-v1 v1)"
          }
        },
        "additionalProperties": false
      },
      "PremiumListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Premium"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PremiumResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Premium"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "PremiumStatus": {
        "type": "string",
        "enum": [
          "draft",
          "pending",
          "active",
          "expired",
          "cancelled"
        ],
        "description": "Aggregate-premium record lifecycle status (contract rule \u2014 the record lifecycle, not the\ncollection lifecycle):\n- `draft` \u2014 Premium obligation recorded but not yet activated (e.g. a\n  manually-entered / imported inflow obligation; never an authoritative\n  owed figure, contract rule).\n- `pending` \u2014 Premium is awaiting activation.\n- `active` \u2014 Premium obligation is in force.\n- `expired` \u2014 Premium obligation has lapsed at end of its effective window.\n- `cancelled` \u2014 Premium obligation has been cancelled (e.g. policy\n  cancellation mid-term).\n\nNote: `paid` / `overdue` are payment/collection state and live on the\ninstalment (PolicyPremiumScheduleItem.status), NOT on the aggregate premium\n\u2014 relocated, not retired (contract rule, governed contract).\n",
        "example": "draft"
      },
      "PricingRule": {
        "type": "object",
        "required": [
          "id",
          "name",
          "rule_type",
          "base_rate",
          "status"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique pricing rule identifier",
            "example": "prd_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "pricing-rule-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "name": {
            "type": "string",
            "description": "Display name of the pricing rule",
            "example": "Age Rating Factor"
          },
          "rule_type": {
            "type": "string",
            "enum": [
              "age_factor",
              "risk_factor",
              "coverage_factor"
            ],
            "description": "Classification of the pricing rule.\n- age_factor: Adjusts premium based on insured's age\n- risk_factor: Adjusts premium based on risk assessment\n- coverage_factor: Adjusts premium based on selected coverage options\n",
            "example": "age_factor"
          },
          "base_rate": {
            "type": "number",
            "format": "double",
            "description": "Base rate or multiplier for this pricing rule",
            "example": 1.25
          },
          "expression": {
            "type": [
              "string",
              "null"
            ],
            "description": "CEL expression for dynamic rate calculation",
            "example": "age >= 50 ? 1.5 : 1.0"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes for rule configuration",
            "example": {
              "age_bands": [
                {
                  "min_age": 18,
                  "max_age": 35,
                  "factor": 1
                },
                {
                  "min_age": 36,
                  "max_age": 50,
                  "factor": 1.25
                }
              ]
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Whether this pricing rule is currently applied",
            "example": "active"
          }
        },
        "additionalProperties": false
      },
      "Product": {
        "type": "object",
        "required": [
          "id",
          "product_code",
          "name",
          "type",
          "status",
          "description",
          "currency",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "pattern": "^prd_[A-Za-z0-9]+$",
            "description": "Typed product identifier rendered on the wire. The storage UUID remains internal.",
            "example": "prd_3f8a9c1e2b7d4f60",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "product_code": {
            "type": "string",
            "description": "Human-readable product code used for catalogue reference",
            "example": "HEALTH-COMP-2026"
          },
          "name": {
            "type": "string",
            "description": "Display name of the product",
            "example": "Comprehensive Health Cover"
          },
          "type": {
            "type": "string",
            "enum": [
              "life",
              "health",
              "property",
              "motor",
              "liability",
              "travel",
              "gadget",
              "business",
              "other"
            ],
            "description": "Product classification. The current alpha contract accepts only this published set; unsupported values such as `composite` are rejected at the request boundary.",
            "example": "health"
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "deprecated",
              "retired"
            ],
            "description": "Product lifecycle status.\n- draft: Product is being configured and is not yet available for policy issuance\n- active: Product is published and available for policy issuance\n- deprecated: Product is superseded and retained for as-was auditability\n- retired: Product is no longer available and retained for reconstruction\n",
            "example": "draft"
          },
          "description": {
            "type": "string",
            "description": "Detailed description of the product and its coverage",
            "example": "Comprehensive health insurance covering inpatient, outpatient, and dental care"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO-4217 currency code for premiums and limits",
            "example": "zar"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible key-value pairs for product-specific configuration",
            "example": {
              "underwriting_class": "standard",
              "renewable": true
            }
          },
          "covers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/Cover"
            },
            "description": "Coverage sections included in this product"
          },
          "terms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ProductTerm"
            },
            "description": "Configurable terms and parameters for the product"
          },
          "annotations": {
            "type": [
              "array",
              "null"
            ],
            "description": "governed contract \u2014 per-element human annotations (\"4GL on steroids\") explaining\nthe product for a human (or agent) reader.\n",
            "items": {
              "type": "object",
              "properties": {
                "element": {
                  "type": "string",
                  "description": "The element annotated."
                },
                "meaning": {
                  "type": "string",
                  "description": "Plain-English explanation of what the element means."
                },
                "source_ref": {
                  "type": "string",
                  "description": "Section/page reference into the source document."
                }
              },
              "additionalProperties": false
            }
          },
          "source_provenance_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "governed contract \u2014 soft reference to the source_provenance record (source URL,\nSHA-256, publication date, markdown + PDF archive objects, section/page anchors).\n"
          },
          "pricing_rules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/PricingRule"
            },
            "description": "Rules governing premium calculation"
          },
          "commissions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/Commission"
            },
            "description": "Commission structures for intermediary roles"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the product was created",
            "example": "2026-01-10T08:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the product was last updated",
            "example": "2026-02-01T16:30:00Z"
          }
        },
        "additionalProperties": false
      },
      "ProductDecisionCode": {
        "type": "string",
        "enum": [
          "accept",
          "blocked",
          "decline",
          "refer",
          "manual_review_required",
          "eligible",
          "ineligible",
          "pending_evidence"
        ],
        "description": "Stable routeable business result from a completed evaluation."
      },
      "ProductDecisionEvaluation": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "decision_evaluation_id",
          "decision_intent",
          "product_stage",
          "decision_code",
          "reason_codes",
          "routeable_outputs",
          "binding",
          "audit_ref",
          "explanation_ref",
          "evaluation_at",
          "canonical_request_hash"
        ],
        "properties": {
          "decision_evaluation_id": {
            "type": "string",
            "pattern": "^pde_[A-Za-z0-9]+$",
            "description": "Product decision evaluation identifier.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "decision_intent": {
            "$ref": "#/components/schemas/ProductDecisionIntent"
          },
          "product_stage": {
            "$ref": "#/components/schemas/ProductDecisionStage"
          },
          "decision_code": {
            "$ref": "#/components/schemas/ProductDecisionCode"
          },
          "reason_codes": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[a-z][a-z0-9_]*$"
            },
            "description": "Stable lowercase reason codes backing the decision."
          },
          "routeable_outputs": {
            "type": "object",
            "additionalProperties": true,
            "description": "Stable facts an external process may route on."
          },
          "binding": {
            "$ref": "#/components/schemas/ProductDecisionEvaluationBinding"
          },
          "audit_ref": {
            "type": "string",
            "description": "Reference to the audit evidence written for the evaluation."
          },
          "explanation_ref": {
            "type": "string",
            "description": "Reference to the explanation evidence written for the evaluation."
          },
          "evaluation_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp at which Axiom completed the evaluation."
          },
          "canonical_request_hash": {
            "type": "string",
            "pattern": "^sha256:[a-f0-9]{64}$"
          }
        }
      },
      "ProductDecisionEvaluationBinding": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "ruleset_type",
          "ruleset_id",
          "ruleset_version",
          "effective_at"
        ],
        "properties": {
          "ruleset_type": {
            "type": "string",
            "enum": [
              "annual_cap",
              "cancellation_and_refunds",
              "claims_assessment",
              "commission",
              "coverage",
              "discount",
              "document_completeness",
              "eligibility",
              "payments",
              "premium_collection",
              "premium_rating",
              "procedure_eligibility",
              "proration_adjustments",
              "rating",
              "regulatory",
              "shortfall_calculation",
              "waiting_periods"
            ],
            "description": "Server-resolved ruleset type selected by Axiom."
          },
          "ruleset_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Server-resolved typed-prefix ruleset identifier selected by Axiom.",
            "example": "rst_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "ruleset-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "ruleset_version": {
            "type": "integer",
            "minimum": 1,
            "description": "Server-resolved ruleset version selected by Axiom."
          },
          "pipeline_version": {
            "type": [
              "string",
              "null"
            ],
            "description": "Server-resolved pipeline version when a pipeline participates in the evaluation."
          },
          "effective_at": {
            "type": "string",
            "format": "date-time",
            "description": "Effective timestamp used for binding resolution."
          }
        }
      },
      "ProductDecisionEvaluationRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "decision_intent",
          "product_stage",
          "effective_at",
          "requested_outputs",
          "facts",
          "canonical_request_hash"
        ],
        "properties": {
          "decision_intent": {
            "$ref": "#/components/schemas/ProductDecisionIntent"
          },
          "product_stage": {
            "$ref": "#/components/schemas/ProductDecisionStage"
          },
          "effective_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp used for as-was product binding resolution."
          },
          "requested_outputs": {
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
              "$ref": "#/components/schemas/ProductDecisionRequestedOutput"
            }
          },
          "facts": {
            "type": "object",
            "additionalProperties": true,
            "description": "Controlled input facts or references needed by the named decision\nintent. Facts are data only and never grant tenant, ruleset, pipeline,\nretention, or explanation authority. Runtime evaluation must reject\nnested authority-shaped facts such as raw ruleset, pipeline, tenant,\nretention, explanation-audience, transport-status, or\ninfrastructure-status selectors.\n"
          },
          "canonical_request_hash": {
            "type": "string",
            "pattern": "^sha256:[a-f0-9]{64}$",
            "description": "SHA-256 hash of the canonical product decision evaluation request\npayload. The canonical payload contains exactly `decision_intent`,\n`product_stage`, `effective_at` normalized to UTC RFC3339/RFC3339Nano,\n`requested_outputs` in caller-supplied order, and `facts`. It excludes\n`canonical_request_hash`, the path product id, tenant context, actor\ncontext, correlation headers, and idempotency headers. The canonical\npayload bytes are compact UTF-8 JSON with lexicographically sorted\nobject member names at every object depth and no insignificant\nwhitespace. `effective_at` is rendered in UTC RFC3339Nano form with a\ntrailing `Z`. JSON number values are encoded as JSON numbers, not\nstrings. String values use JSON string escaping without HTML escaping.\n"
          }
        }
      },
      "ProductDecisionEvaluationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ProductDecisionEvaluation"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ProductDecisionIntent": {
        "type": "string",
        "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$",
        "example": "underwriting.outcome",
        "description": "Decision intent name from the contract-owned decision-intent registry.\nSlice 1 admits the naming and validation shape; runtime registry lookup is\nowned by the implementation slice.\n"
      },
      "ProductDecisionRequestedOutput": {
        "type": "string",
        "enum": [
          "decision_code",
          "reason_codes",
          "routeable_outputs",
          "required_document_codes",
          "premium_amount",
          "referral_reason",
          "settlement_amount"
        ],
        "description": "Outputs the caller may ask to receive. Axiom still decides which admitted\noutputs are valid for the requested decision intent and product stage.\n"
      },
      "ProductDecisionStage": {
        "type": "string",
        "pattern": "^[a-z][a-z0-9_]*$",
        "example": "underwriting",
        "description": "Product-stage name from the contract-owned product-stage registry. A stage\nnames process decision context; it does not select a ruleset or workflow\nmodel.\n"
      },
      "ProductListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Product"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ProductResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Product"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ProductRulesetBinding": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique binding identifier",
            "format": "typed-prefix-id",
            "pattern": "^prb_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "prb_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-ruleset-binding-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "product_id": {
            "type": "string",
            "description": "Typed product identifier",
            "format": "typed-prefix-id",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "ruleset_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed-prefix identifier of the bound ruleset.",
            "example": "rst_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "ruleset-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "ruleset_type": {
            "type": "string",
            "enum": [
              "annual_cap",
              "cancellation_and_refunds",
              "claims_assessment",
              "commission",
              "coverage",
              "discount",
              "document_completeness",
              "eligibility",
              "payments",
              "premium_collection",
              "premium_rating",
              "procedure_eligibility",
              "proration_adjustments",
              "rating",
              "regulatory",
              "shortfall_calculation",
              "waiting_periods"
            ],
            "description": "Canonical ruleset_type / pipeline stage this binding satisfies. The\naccepted set mirrors the documented ruleset type allowlist\nand `Ruleset.entity_type`; unknown values fail closed at the service\nboundary.\n"
          },
          "ruleset_version": {
            "type": "integer",
            "description": "Version number of the bound ruleset"
          },
          "effective_from": {
            "type": "string",
            "format": "date-time",
            "description": "ISO 8601 timestamp when this binding becomes active"
          },
          "effective_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "ISO 8601 timestamp when this binding was superseded (null if still active)"
          },
          "created_by": {
            "type": "string",
            "description": "Actor ID that created the binding"
          }
        },
        "additionalProperties": false
      },
      "ProductRulesetBindingListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ProductRulesetBinding"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ProductRulesetBindingResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ProductRulesetBinding"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ProductTerm": {
        "type": "object",
        "required": [
          "id",
          "code",
          "name",
          "data_type",
          "required"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique term identifier",
            "example": "prd_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "product-term-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "code": {
            "type": "string",
            "description": "Short code for this configurable term",
            "example": "POLICY-TERM-MONTHS",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Display name",
            "example": "Policy Term"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Explanation of this term and how it affects the product",
            "example": "Duration of the policy in months"
          },
          "data_type": {
            "type": "string",
            "description": "Data type for this term's value (e.g. string, integer, number, boolean, date)",
            "example": "integer"
          },
          "required": {
            "type": "boolean",
            "description": "Whether this term must be provided when issuing a policy",
            "example": true
          },
          "default_value": {
            "type": [
              "string",
              "null"
            ],
            "description": "Default value when not explicitly provided",
            "example": "12"
          },
          "validations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ValidationRule"
            },
            "description": "Validation rules applied to this term's value"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes"
          }
        },
        "additionalProperties": false
      },
      "ProductTermCreate": {
        "type": "object",
        "required": [
          "code",
          "name",
          "data_type",
          "required"
        ],
        "properties": {
          "code": {
            "type": "string",
            "description": "Short code for this configurable term",
            "example": "POLICY-TERM-MONTHS",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Display name",
            "example": "Policy Term"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Explanation of this term and how it affects the product",
            "example": "Duration of the policy in months"
          },
          "data_type": {
            "type": "string",
            "description": "Data type for this term's value (e.g. string, integer, number, boolean, date)",
            "example": "integer"
          },
          "required": {
            "type": "boolean",
            "description": "Whether this term must be provided when issuing a policy",
            "example": true
          },
          "default_value": {
            "type": [
              "string",
              "null"
            ],
            "description": "Default value when not explicitly provided",
            "example": "12"
          },
          "validations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ValidationRule"
            },
            "description": "Validation rules applied to this term's value"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes"
          }
        },
        "additionalProperties": false
      },
      "ProrationAdjustmentComponent": {
        "type": "object",
        "description": "Typed effect emitted by a proration decision.",
        "required": [
          "component_type",
          "consumer",
          "affected"
        ],
        "additionalProperties": false,
        "properties": {
          "component_type": {
            "type": "string",
            "enum": [
              "money",
              "premium_earning",
              "cover_limit",
              "waiting_period",
              "cover_period",
              "savings_fund",
              "backpay_debt",
              "entitlement_restoration",
              "reinsurance",
              "refusal"
            ]
          },
          "consumer": {
            "type": "string",
            "enum": [
              "ledger",
              "entitlement_balance",
              "temporal_gate",
              "fund_balance",
              "earning_balance",
              "reinsurance_balance",
              "explanation_only"
            ]
          },
          "affected": {
            "type": "object",
            "additionalProperties": true,
            "description": "References to the affected primitive instances."
          },
          "amount_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Exact integer minor units for money components."
          },
          "currency": {
            "type": "string",
            "description": "Lowercase ISO-4217 currency when amount_minor is present."
          },
          "ratio_bps": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "description": "Exact basis-point ratio when the component represents a proportion."
          },
          "effective_start": {
            "type": "string",
            "format": "date-time"
          },
          "effective_end": {
            "type": "string",
            "format": "date-time"
          },
          "reason_code": {
            "type": "string",
            "description": "Tenant-owned reason code or fail-closed code."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "ProrationAdjustmentDecision": {
        "type": "object",
        "description": "Event-effective proration decision resource.",
        "required": [
          "id",
          "event_id",
          "status",
          "event_type",
          "proration_intent",
          "components",
          "ledger_entry_ids",
          "explanation_tree_id",
          "evidence_entry_id",
          "ruleset"
        ],
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Proration decision typed-prefix identifier.",
            "example": "pde_01arz3ndektsv4rrffq69g5fav",
            "pattern": "^pde_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "proration-decision-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "event_id": {
            "type": "string",
            "description": "Triggering event identity in wire form.",
            "example": "event-2026-03-08-001",
            "x-axiom-identifier-classification": "event-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "status": {
            "type": "string",
            "enum": [
              "posted",
              "evaluated",
              "refused"
            ]
          },
          "event_type": {
            "type": "string",
            "description": "Event type resolved from the existing triggering event row."
          },
          "proration_intent": {
            "type": "string",
            "description": "Tenant ruleset key used for evaluation."
          },
          "components": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProrationAdjustmentComponent"
            }
          },
          "ledger_entry_ids": {
            "type": "array",
            "description": "Ledger entry ids created by financial components; empty for zero-money/refused decisions.",
            "items": {
              "type": "string"
            }
          },
          "explanation_tree_id": {
            "type": "string",
            "description": "Durable explanation tree identity in wire form.",
            "x-axiom-identifier-classification": "explanation-tree-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "evidence_entry_id": {
            "type": "integer",
            "format": "int64",
            "description": "governed contract evidence journal entry id for the persisted decision."
          },
          "ruleset": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "ruleset_type",
              "ruleset_id",
              "ruleset_version",
              "resolved_at"
            ],
            "properties": {
              "ruleset_type": {
                "type": "string",
                "example": "proration_adjustments"
              },
              "ruleset_id": {
                "type": "string",
                "format": "typed-prefix-id",
                "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
                "description": "Typed-prefix identifier for the resolved ruleset.",
                "example": "rst_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "ruleset-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "ruleset_version": {
                "type": "string"
              },
              "resolved_at": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "correction_of_decision_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original decision id when this decision corrects a prior one."
          }
        }
      },
      "ProrationAdjustmentRequest": {
        "type": "object",
        "description": "Request to apply a tenant-owned event-effective proration decision. Tenant,\nactor, event type, event effective time, active policy version,\npolicy-product binding, affected party-role authority, affected\npolicy-object authority, product-cover/term authority, ruleset\nbinding/version, ledger categories, and balance-consumer authority are\nderived or validated by the server and must not be supplied as overrides by\nthe caller. Policy and product identities are governed references used for\nserver-side validation and binding resolution; caller-supplied\npolicy-version or product-version overrides are rejected.\n",
        "required": [
          "policy_id",
          "product_id",
          "proration_intent",
          "affected",
          "effective_times"
        ],
        "additionalProperties": false,
        "properties": {
          "policy_id": {
            "type": "string",
            "description": "Policy identity in wire form.",
            "example": "pol_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "premium_id": {
            "type": "string",
            "description": "Optional premium identity in wire form when the decision affects a known premium.",
            "example": "prm_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "format": "typed-prefix-id",
            "pattern": "^prm_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "premium-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "product_id": {
            "type": "string",
            "description": "Product identity in wire form. Used by the server to resolve the proration_adjustments ruleset binding.",
            "example": "prd_01j9zxkp8wqrm2n4v6t5s3d7f1",
            "format": "typed-prefix-id",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "proration_intent": {
            "type": "string",
            "description": "Tenant ruleset key that declares what adjustment intent to evaluate.",
            "example": "mid_year_join"
          },
          "reason": {
            "type": "string",
            "description": "Operator-supplied reason for the adjustment request.",
            "maxLength": 1024
          },
          "correction_of_decision_id": {
            "type": "string",
            "description": "Existing proration decision UUID corrected by this decision.",
            "format": "typed-prefix-id",
            "pattern": "^pde_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pde_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "proration-decision-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "affected": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "party_role_id"
            ],
            "properties": {
              "party_role_id": {
                "type": "string",
                "description": "Affected party-in-role identity in wire form.",
                "x-axiom-identifier-classification": "typed-prefix-wire-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "cover_id": {
                "type": "string",
                "description": "Affected cover identity or tenant cover code, if cover-specific.",
                "format": "typed-prefix-id",
                "pattern": "^cov_[0-9a-hjkmnp-tv-z]{26}$",
                "example": "cov_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "cover-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "cover_term_id": {
                "type": "string",
                "description": "Affected cover-level term identity or tenant term code, if term-specific.",
                "format": "typed-prefix-id",
                "pattern": "^cvt_[0-9a-hjkmnp-tv-z]{26}$",
                "example": "cvt_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "cover-term-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "cover_item_id": {
                "type": "string",
                "description": "Affected cover-item identity or tenant cover-item code, if term-specific.",
                "format": "typed-prefix-id",
                "pattern": "^cit_[0-9a-hjkmnp-tv-z]{26}$",
                "example": "cit_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "cover-item-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "cover_item_term_id": {
                "type": "string",
                "description": "Affected cover-item term identity or tenant term code, if term-specific.",
                "format": "typed-prefix-id",
                "pattern": "^coi_[0-9a-hjkmnp-tv-z]{26}$",
                "example": "coi_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "cover-item-term-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "policy_object_id": {
                "type": "string",
                "description": "Affected insured object identity in pob_ wire form, if object-specific.",
                "format": "typed-prefix-id",
                "pattern": "^pob_[0-9a-hjkmnp-tv-z]{26}$",
                "example": "pob_01arz3ndektsv4rrffq69g5fav",
                "x-axiom-identifier-classification": "policy-object-id",
                "x-axiom-identifier-shape": "typed-prefix"
              },
              "treaty_id": {
                "type": "string",
                "description": "Reserved for future governed treaty authority; current runtime rejects reinsurance proration until that authority substrate exists.",
                "x-axiom-identifier-classification": "reserved-treaty-id",
                "x-axiom-identifier-shape": "opaque-string"
              }
            }
          },
          "effective_times": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "premium_period_start",
              "premium_period_end"
            ],
            "properties": {
              "premium_period_start": {
                "type": "string",
                "format": "date-time",
                "description": "Start of the premium period to evaluate."
              },
              "premium_period_end": {
                "type": "string",
                "format": "date-time",
                "description": "End of the premium period to evaluate."
              },
              "cover_start": {
                "type": "string",
                "format": "date-time",
                "description": "Start of the cover-effective interval when different from premium period."
              },
              "cover_end": {
                "type": "string",
                "format": "date-time",
                "description": "End of the cover-effective interval when different from premium period."
              },
              "entitlement_start": {
                "type": "string",
                "format": "date-time",
                "description": "Start of the entitlement interval when applicable."
              },
              "entitlement_end": {
                "type": "string",
                "format": "date-time",
                "description": "End of the entitlement interval when applicable."
              }
            }
          },
          "inputs": {
            "type": "object",
            "description": "Tenant-owned rule inputs. Shape is validated by the resolved tenant ruleset.",
            "additionalProperties": true
          }
        }
      },
      "ProrationAdjustmentResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ProrationAdjustmentDecision"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ProrationBalanceResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ProrationBalanceResult"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ProrationBalanceResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "currency",
          "amount",
          "item_count"
        ],
        "properties": {
          "currency": {
            "type": "string",
            "description": "Lowercase ISO-4217 currency for money balances."
          },
          "amount": {
            "type": "string",
            "description": "Decimal string amount produced by the governed contract balance engine.",
            "x-axiom-money-classification": "decimal-string-alpha-exception",
            "x-axiom-money-currency-association": "sibling-currency-field",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "item_count": {
            "type": "integer"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true
          },
          "explanation": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "QueryEvidenceResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/EvidenceRecord"
                }
              },
              "meta": {
                "type": "object",
                "properties": {
                  "next_cursor": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "Quote": {
        "type": "object",
        "required": [
          "quote_id",
          "product_id",
          "effective_date",
          "expiry_date",
          "underwriting_data",
          "covers_selected",
          "pricing_snapshot",
          "created_at",
          "valid_until",
          "actor_type",
          "actor_id",
          "actor_original_id"
        ],
        "properties": {
          "quote_id": {
            "type": "string",
            "example": "qte_01arz3ndektsv4rrffq69g5fav",
            "format": "typed-prefix-id",
            "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "quote-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "product_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^prd_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "prd_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "product-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "effective_date": {
            "type": "string",
            "format": "date-time"
          },
          "expiry_date": {
            "type": "string",
            "format": "date-time"
          },
          "underwriting_data": {
            "type": "object",
            "additionalProperties": true
          },
          "covers_selected": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "pricing_snapshot": {
            "type": "object",
            "description": "Full premium calculation result snapshot (JSONB)",
            "additionalProperties": false
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "valid_until": {
            "type": "string",
            "format": "date-time"
          },
          "actor_type": {
            "type": "string",
            "description": "Actor type that created the quote (governed contract)",
            "example": "human"
          },
          "actor_id": {
            "type": "string",
            "description": "Actor identifier that created the quote (governed contract)",
            "format": "typed-prefix-id",
            "pattern": "^act_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "act_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "actor_original_id": {
            "type": "string",
            "description": "Original actor identifier before delegation (governed contract)",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "comparison_ref": {
            "type": "string",
            "description": "Links comparison sets for quote comparison"
          },
          "supersedes_quote_id": {
            "type": "string",
            "description": "Quote ID this quote supersedes",
            "format": "typed-prefix-id",
            "pattern": "^qte_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "qte_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "quote-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "parties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QuoteParty"
            },
            "description": "Party snapshot for bind-time matching"
          }
        },
        "additionalProperties": false
      },
      "QuoteListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Quote"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "QuoteParty": {
        "type": "object",
        "required": [
          "party_id",
          "role"
        ],
        "properties": {
          "party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^pty_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pty_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "party-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "role": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "QuoteResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Quote"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "RecordClaimAuthorisationRequest": {
        "type": "object",
        "required": [
          "transition_kind",
          "authorisation_kind",
          "authorising_actor",
          "decision_date",
          "explanation_node_id"
        ],
        "properties": {
          "logical_authorisation_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logical thread id for grant/amend/revoke chains. Generated when omitted."
          },
          "transition_kind": {
            "type": "string",
            "description": "Sector-neutral transition verb.",
            "example": "authorisation-granted"
          },
          "authorisation_kind": {
            "type": "string",
            "description": "Tenant-keyed authorisation kind.",
            "example": "pre-auth"
          },
          "authorising_actor": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rol_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Party-in-role actor that granted the authorisation.",
            "example": "rol_01arz3ndektsv4rrffq69g5fav"
          },
          "authorised_scope": {
            "type": "object",
            "additionalProperties": true,
            "description": "Typed grant envelope such as procedures, codes, or engagement scope."
          },
          "budget_minor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Exact integer minor units for the authorised budget ceiling."
          },
          "budget_currency_code": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-z]{3}$",
            "description": "Lowercase ISO-4217 currency code. Present iff budget_minor is present."
          },
          "governing_version_kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "Governing-version discriminator such as catalogue, rule, cover, or engagement-terms."
          },
          "governing_version_row_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Immutable row-id revision of the governing version current at the decision date."
          },
          "compliance_kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tenant-keyed compliance kind such as accreditation or sanctions-screening."
          },
          "compliance_outcome": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "clear",
              "hit",
              "pending",
              "unset",
              "override"
            ],
            "description": "Compliance outcome consulted by the payment gate when payment cites this authorisation."
          },
          "compliance_list_version": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tenant-supplied as-was list or standard version."
          },
          "compliance_list_authority": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tenant-keyed list authority such as cms, ofac, ofsi, or eu."
          },
          "decision_date": {
            "type": "string",
            "format": "date-time",
            "description": "Moment the authorisation decision was made."
          },
          "explanation_node_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^een_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Edge explanation-node reference for the authorisation decision.",
            "example": "een_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "edge-explanation-node-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "finding_reference": {
            "type": [
              "string",
              "null"
            ],
            "description": "Required by the persistence rule on revoke or withdrawal transitions."
          }
        },
        "additionalProperties": false
      },
      "RecordClaimAuthorisationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/AuthorisationTransition"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ReestablishReserveRequest": {
        "type": "object",
        "required": [
          "amount"
        ],
        "properties": {
          "amount": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "description": "New reserve amount in exact integer minor units.",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "reason": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "ReestablishReserveResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "reserve",
                  "predecessor_id",
                  "successor_id",
                  "operation"
                ],
                "properties": {
                  "reserve": {
                    "$ref": "#/components/schemas/ClaimReserve"
                  },
                  "predecessor_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "successor_id": {
                    "type": "string",
                    "format": "typed-prefix-id",
                    "x-axiom-identifier-shape": "typed-prefix"
                  },
                  "operation": {
                    "type": "string",
                    "enum": [
                      "reestablish"
                    ]
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ReleaseReserveRequest": {
        "type": "object",
        "required": [
          "amount"
        ],
        "properties": {
          "amount": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "description": "Amount to release in exact integer minor units.",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "reason": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "ReserveListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ClaimReserve"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ReserveResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/ClaimReserve"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ResourceId": {
        "type": "string",
        "format": "typed-prefix-id",
        "description": "Typed-prefix resource identifier. Wire format: `{prefix}_{crockford-base32-uuid}` (30 chars). The prefix is an exactly three-character lowercase entity family tag (e.g. `pty` for party); the suffix is the lowercase Crockford Base32 encoding of the underlying storage UUID. Example encoding of storage UUID typed_id_example_01 uses wire/display form `pty_00000000000000000000000000`.\n",
        "pattern": "^[a-z]{3}_[0-9a-hjkmnp-tv-z]{26}$",
        "example": "pty_01abcdefghjkmnpqrstvwxyz01",
        "x-axiom-identifier-shape": "typed-prefix"
      },
      "ResponseTelemetry": {
        "type": "object",
        "required": [
          "request_id",
          "server_time",
          "api_version",
          "build",
          "timing",
          "idempotency_replayed"
        ],
        "properties": {
          "build": {
            "type": "string",
            "description": "Serving build identity; the same runtime stamp used by health, distinct from API contract version."
          },
          "request_id": {
            "type": "string",
            "description": "Gateway-minted request identifier echoed in X-Request-ID.",
            "x-axiom-identifier-classification": "request-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "server_time": {
            "type": "string",
            "format": "date-time",
            "description": "UTC timestamp when the response envelope was written."
          },
          "api_version": {
            "type": "string",
            "description": "Resolved API contract version for the request.",
            "example": "0.1.0"
          },
          "timing": {
            "type": "object",
            "required": [
              "total_ms",
              "handler_ms"
            ],
            "properties": {
              "total_ms": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              },
              "handler_ms": {
                "type": "integer",
                "format": "int64",
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          "idempotency_replayed": {
            "type": "boolean",
            "description": "True when the response came from the idempotency replay cache."
          },
          "trace_id": {
            "type": "string",
            "description": "Optional distributed trace identifier when tracing is active.",
            "x-axiom-identifier-classification": "trace-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "RoleContext": {
        "type": "object",
        "required": [
          "entity_type",
          "entity_id"
        ],
        "properties": {
          "entity_type": {
            "type": "string",
            "enum": [
              "policy",
              "claim",
              "organization",
              "product",
              "policy_item",
              "group"
            ],
            "description": "The type of entity this role is scoped to. `group` identifies a PartyGroup context while the assignee remains the Party.",
            "example": "group"
          },
          "entity_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "The identifier of the entity this role is scoped to",
            "example": "pol_01j9zxkp8wqrm2n4v6t5s3d7f4",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "RoleTypeListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PartyRoleTypeEntry"
                },
                "example": [
                  {
                    "code": "policyholder",
                    "display_name": "Policyholder",
                    "universal": true,
                    "assignable_context_types": [
                      "policy",
                      "policy_item"
                    ],
                    "requires_attribution": true
                  },
                  {
                    "code": "beneficiary",
                    "display_name": "Beneficiary",
                    "universal": true,
                    "assignable_context_types": [
                      "policy",
                      "policy_item"
                    ],
                    "requires_attribution": true
                  }
                ]
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "RoleTypeUsageItem": {
        "type": "object",
        "required": [
          "code",
          "count"
        ],
        "properties": {
          "code": {
            "type": "string",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "count": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "RoleTypeUsageListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/RoleTypeUsageItem"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "RuleAction": {
        "type": "object",
        "required": [
          "action_type",
          "target",
          "value"
        ],
        "properties": {
          "action_type": {
            "type": "string",
            "description": "Type of action to execute.\nCommon types: set_field, emit_event, add_loading, apply_discount,\nreject, approve, escalate, notify.\n",
            "example": "add_loading"
          },
          "target": {
            "type": "string",
            "description": "Target field or entity the action applies to",
            "example": "premium.young_driver_loading"
          },
          "value": {
            "description": "Value to set, apply, or emit. Type depends on the action_type.",
            "example": 0.15
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Additional parameters for the action",
            "example": {
              "reason": "Driver under 25 \u2014 young driver loading applied",
              "loading_type": "percentage"
            }
          }
        },
        "additionalProperties": false
      },
      "RuleCondition": {
        "type": "object",
        "required": [
          "field",
          "operator",
          "value"
        ],
        "properties": {
          "field": {
            "type": "string",
            "description": "Dot-notation path to the field being evaluated",
            "example": "vehicle.year_of_manufacture"
          },
          "operator": {
            "type": "string",
            "description": "Comparison operator to apply.\nCommon operators: eq, ne, gt, gte, lt, lte, in, not_in, contains, matches.\n",
            "example": "gte"
          },
          "value": {
            "description": "Value to compare against. Type depends on the field and operator.",
            "example": 2015
          },
          "logic": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logical connector to the next condition.\n- and: Both this and the next condition must be true\n- or: Either this or the next condition must be true\nIf omitted on the last condition, defaults to implicit AND with the rule expression.\n",
            "enum": [
              "and",
              "or"
            ],
            "example": "and"
          }
        },
        "additionalProperties": false
      },
      "RuleEvaluationResult": {
        "type": "object",
        "required": [
          "rule_id",
          "rule_name",
          "outcome",
          "executed_at"
        ],
        "properties": {
          "rule_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed-prefix identifier for the rule definition.",
            "example": "rul_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "rule_name": {
            "type": "string",
            "description": "Human-readable rule name",
            "example": "Fraud Probability Score"
          },
          "outcome": {
            "type": "string",
            "description": "Rule evaluation outcome (e.g. pass, fail, warn, skip)",
            "example": "pass"
          },
          "value": {
            "type": [
              "string",
              "null"
            ],
            "description": "Rule evaluation output value (type depends on the rule)",
            "example": "0.12"
          },
          "error": {
            "type": [
              "string",
              "null"
            ],
            "description": "Error message if rule evaluation failed",
            "example": null
          },
          "executed_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the rule was evaluated",
            "example": "2026-02-18T15:58:00Z"
          }
        },
        "additionalProperties": false
      },
      "Ruleset": {
        "type": "object",
        "required": [
          "id",
          "code",
          "name",
          "entity_type",
          "description",
          "status",
          "version",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique ruleset identifier",
            "example": "rst_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^rst_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "ruleset-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "code": {
            "type": "string",
            "description": "Machine-readable code for the ruleset. Used for programmatic reference\nand cross-referencing with product configurations.\n",
            "example": "motor-comprehensive-v1",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "name": {
            "type": "string",
            "description": "Human-readable name for the ruleset",
            "example": "Motor Vehicle Rating Rules"
          },
          "entity_type": {
            "type": "string",
            "enum": [
              "annual_cap",
              "cancellation_and_refunds",
              "claims_assessment",
              "commission",
              "coverage",
              "discount",
              "document_completeness",
              "eligibility",
              "payments",
              "premium_collection",
              "premium_rating",
              "procedure_eligibility",
              "proration_adjustments",
              "rating",
              "regulatory",
              "shortfall_calculation",
              "waiting_periods"
            ],
            "description": "The canonical ruleset_type / pipeline stage this ruleset governs.\nThis field intentionally uses the same allowlist as ProductRulesetBinding\n(the documented ruleset type allowlist). Retired lane words such\nas `claims`, `pricing`, and `underwriting` are rejected at the service\nboundary.\n",
            "example": "premium_rating"
          },
          "description": {
            "type": "string",
            "description": "Detailed description of what this ruleset covers and its purpose",
            "example": "Validation and pricing rules for comprehensive motor insurance products"
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "deprecated"
            ],
            "description": "Lifecycle status of the ruleset.\n- draft: Under development, not yet available for evaluation\n- active: Published and available for evaluation in policy lifecycles or retained claim-family compatibility lifecycles\n- deprecated: Superseded by a newer version; retained for as-was auditability\n",
            "example": "active"
          },
          "version": {
            "type": "integer",
            "minimum": 1,
            "description": "Monotonically increasing version number. Each modification to rules\ncreates a new version, preserving as-was semantics.\n",
            "example": 3
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible metadata for the ruleset (e.g. jurisdiction, product line, effective dates)",
            "example": {
              "jurisdiction": "US",
              "product_line": "motor",
              "effective_from": "2026-01-01"
            }
          },
          "rules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/BusinessRule"
            },
            "description": "Ordered list of business rules in this ruleset"
          },
          "annotations": {
            "type": [
              "array",
              "null"
            ],
            "description": "governed contract \u2014 per-element human annotations (\"4GL on steroids\"). Each\nentry explains one element of the ruleset for a human (or agent) reader.\n",
            "items": {
              "type": "object",
              "properties": {
                "element": {
                  "type": "string",
                  "description": "The element annotated (e.g. a CEL term, a limit, a value_type)."
                },
                "meaning": {
                  "type": "string",
                  "description": "Plain-English explanation of what the element means."
                },
                "source_ref": {
                  "type": "string",
                  "description": "Section/page reference into the source document."
                }
              },
              "additionalProperties": false
            }
          },
          "source_provenance_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "governed contract \u2014 soft reference to the source_provenance record (source URL,\nSHA-256, publication date, markdown + PDF archive objects, section/page anchors).\n"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the ruleset was created",
            "example": "2026-01-10T08:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the ruleset was last updated",
            "example": "2026-03-01T14:30:00Z"
          }
        },
        "additionalProperties": false
      },
      "RulesetDeleteRuleResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": false,
                "description": "Rule deletion returns the canonical success envelope with null data."
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "RulesetEvaluationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "overall_passed",
                  "results",
                  "rules_count"
                ],
                "properties": {
                  "overall_passed": {
                    "type": "boolean",
                    "example": true
                  },
                  "results": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/RulesetEvaluationResult"
                    }
                  },
                  "rules_count": {
                    "type": "integer",
                    "minimum": 0,
                    "example": 2
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "RulesetEvaluationResult": {
        "type": "object",
        "required": [
          "rule_id",
          "rule_name",
          "passed",
          "outcome",
          "message"
        ],
        "properties": {
          "rule_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^rul_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed-prefix identifier for the evaluated rule.",
            "example": "rul_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "rule_name": {
            "type": "string",
            "example": "Minimum Driver Age Rule"
          },
          "passed": {
            "type": "boolean",
            "description": "Whether the rule evaluation passed.",
            "example": true
          },
          "outcome": {
            "type": "string",
            "description": "Runtime evaluation outcome.",
            "example": "passed"
          },
          "message": {
            "type": "string",
            "description": "Empty when the rule succeeded; contains evaluation error detail when available.",
            "example": ""
          }
        },
        "additionalProperties": false
      },
      "RulesetListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Ruleset"
                }
              },
              "meta": {
                "$ref": "#/components/schemas/PaginationMeta"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "RulesetResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/Ruleset"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "SchemaDefinition-2": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "esd_01arz3ndektsv4rrffq69g5fav",
            "pattern": "^esd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "extension-schema-definition-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "name": {
            "type": "string"
          },
          "scope": {
            "type": "string",
            "enum": [
              "tenant"
            ]
          },
          "entity_type": {
            "type": "string",
            "enum": [
              "party",
              "party_role",
              "party_contact",
              "party_identity",
              "party_relationship",
              "party_group",
              "party_group_membership",
              "party_handling_classification",
              "product",
              "product_term",
              "cover",
              "cover_item",
              "cover_term",
              "cover_item_term",
              "policy",
              "policy_version",
              "event",
              "assertion",
              "assertion_line"
            ]
          },
          "entity_sub_type": {
            "type": "string",
            "description": "Subtype discriminator used in the governed schema identity when present."
          },
          "content": {
            "type": "object",
            "additionalProperties": false
          },
          "version_major": {
            "type": "integer"
          },
          "version_minor": {
            "type": "integer"
          },
          "version_patch": {
            "type": "integer"
          },
          "compatibility": {
            "type": "string",
            "enum": [
              "backward",
              "forward",
              "breaking"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "draft",
              "published",
              "deprecated"
            ]
          },
          "predecessor_schema_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "esd_01arz3ndektsv4rrffq69g5fav",
            "pattern": "^esd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "extension-schema-definition-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "actor_type": {
            "type": "string"
          },
          "actor_id": {
            "type": "string",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "version": {
            "type": "integer",
            "description": "Optimistic lock version"
          },
          "deprecation_reason": {
            "type": "string"
          },
          "deprecation_target_at": {
            "type": "string",
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "SchemaDefinitionResponse-2": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/SchemaDefinition-2"
          },
          "status": {
            "type": "string",
            "example": "success",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          }
        },
        "additionalProperties": false
      },
      "SetLastActiveWorkroomRequest": {
        "type": "object",
        "required": [
          "workroom_id"
        ],
        "properties": {
          "workroom_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          }
        },
        "additionalProperties": false
      },
      "SetWorkroomHiddenRequest": {
        "type": "object",
        "required": [
          "hidden"
        ],
        "properties": {
          "hidden": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "SingleRuleEvaluationResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "required": [
                  "passed",
                  "outcome",
                  "message"
                ],
                "properties": {
                  "passed": {
                    "type": "boolean",
                    "example": true
                  },
                  "outcome": {
                    "type": "string",
                    "example": "passed"
                  },
                  "message": {
                    "type": "string",
                    "example": ""
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "SubmitClaimItemCatalogueRefRequest": {
        "type": "object",
        "required": [
          "catalogue_slug",
          "code",
          "code_role"
        ],
        "properties": {
          "catalogue_slug": {
            "type": "string",
            "minLength": 1,
            "description": "Lowercase tenant catalogue slug."
          },
          "code": {
            "type": "string",
            "minLength": 1,
            "description": "Catalogue code, preserved verbatim.",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "code_role": {
            "type": "string",
            "minLength": 1,
            "description": "Lowercase role played by the catalogue code."
          },
          "service_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          }
        },
        "additionalProperties": false
      },
      "SubmitClaimItemRequest": {
        "type": "object",
        "required": [
          "item_type",
          "description",
          "claimed_amount"
        ],
        "properties": {
          "item_type": {
            "type": "string",
            "minLength": 1,
            "description": "Tenant-defined retained assertion line category."
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "description": "Human-readable description of the asserted line."
          },
          "claimed_amount": {
            "$ref": "#/components/schemas/Money"
          },
          "service_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Optional service date for this line."
          },
          "catalogue_refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubmitClaimItemCatalogueRefRequest"
            }
          }
        },
        "additionalProperties": false
      },
      "SubmitClaimMultipartRequest": {
        "type": "object",
        "description": "Multipart events/assertions submission containing the required `claim_data`\ncompatibility form field and zero to ten binary file parts. The complete\nrequest body is limited to 64 MiB. A request containing more than ten file\nparts is rejected with HTTP 400 and canonical error code `INVALID_REQUEST`.\n",
        "required": [
          "claim_data"
        ],
        "properties": {
          "claim_data": {
            "type": "string",
            "description": "JSON object encoded as a form string. It follows SubmitClaimRequest's single-amount shape; document parts are additional binary properties.\n"
          }
        },
        "additionalProperties": {
          "type": "string",
          "format": "binary"
        }
      },
      "SubmitClaimRequest": {
        "type": "object",
        "required": [
          "event_id",
          "policy_id",
          "primary_party_id"
        ],
        "anyOf": [
          {
            "required": [
              "claimed_amount"
            ]
          },
          {
            "required": [
              "items"
            ]
          }
        ],
        "properties": {
          "event_id": {
            "type": "string",
            "description": "Reference to the insured event",
            "example": "clm_01abcdefghjkmnpqrstvwxyz01",
            "x-axiom-identifier-classification": "event-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "policy_id": {
            "type": "string",
            "description": "Reference to the policy under which the retained assertion is submitted.",
            "example": "pol_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "primary_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Reference to the primary party for the retained assertion.",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f4",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "description": {
            "type": "string",
            "description": "Description of the event/assertion circumstances.",
            "example": "Water damage to ground floor following burst pipe. Affected areas include lounge, kitchen, and hallway flooring."
          },
          "claimed_amount": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Money"
              }
            ],
            "description": "Total amount being asserted (exact integer minor units + lowercase ISO-4217 currency code). Must be non-empty."
          },
          "event_date": {
            "type": "string",
            "format": "date",
            "description": "Date when the insured event occurred (ISO 8601 date)",
            "example": "2026-03-01"
          },
          "priority": {
            "$ref": "#/components/schemas/ClaimPriority"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Extensible attributes for tenant-specific retained compatibility data.",
            "example": {
              "property_address": "15 Bishopsgate, London, EC2N 3AR",
              "damage_type": "water"
            }
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Operational metadata (integration references, source system info)",
            "example": {
              "source_system": "broker-portal",
              "broker_reference": "BRK-2026-0891"
            }
          },
          "items": {
            "type": "array",
            "minItems": 1,
            "description": "Canonical multi-line retained assertion shape. When supplied, the total claimed amount is derived from these lines.\n",
            "items": {
              "$ref": "#/components/schemas/SubmitClaimItemRequest"
            }
          }
        },
        "additionalProperties": false
      },
      "Subprocessor": {
        "type": "object",
        "required": [
          "subprocessor_id",
          "vendor_id",
          "name",
          "service_scope",
          "approval_status"
        ],
        "properties": {
          "subprocessor_id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique subprocessor identifier",
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^sub_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "vendor-subprocessor-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "vendor_id": {
            "type": "string",
            "readOnly": true,
            "description": "Parent vendor this subprocessor operates under",
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "vendor-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "name": {
            "type": "string",
            "description": "Legal or trading name of the subprocessor",
            "example": "AWS EU West 2 London"
          },
          "service_scope": {
            "type": "string",
            "description": "Description of the services the subprocessor provides\nto the parent vendor.\n",
            "example": "Infrastructure hosting and data storage for policy administration"
          },
          "approval_status": {
            "type": "string",
            "enum": [
              "pending",
              "approved",
              "revoked"
            ],
            "description": "Approval status of this subprocessor.\n- pending: Awaiting review and approval\n- approved: Approved for data processing\n- revoked: Previously approved, now revoked\n",
            "example": "approved"
          },
          "approved_by": {
            "type": [
              "string",
              "null"
            ],
            "readOnly": true,
            "description": "Identifier of the user who approved this subprocessor",
            "example": "compliance-officer-001"
          },
          "approved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when approval was granted",
            "example": "2026-01-20T11:30:00Z"
          },
          "change_reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reason for the most recent status change",
            "example": "Annual subprocessor review completed \u2014 SOC 2 Type II report verified"
          }
        },
        "additionalProperties": false
      },
      "SubprocessorApprovalDecisionRequest": {
        "type": "object",
        "description": "JSON:API envelope for an authorized subprocessor approval decision",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "type",
              "attributes"
            ],
            "properties": {
              "type": {
                "type": "string",
                "example": "subprocessor-approval-decisions",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "type": "object",
                "required": [
                  "status",
                  "decision_basis"
                ],
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "pending",
                      "approved",
                      "revoked"
                    ],
                    "description": "New subprocessor approval status decided by an authorized actor",
                    "example": "approved"
                  },
                  "decision_basis": {
                    "type": "string",
                    "description": "Human-readable basis for the approval decision",
                    "example": "DPA and subprocessor security evidence accepted"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "SubprocessorDataEnvelope": {
        "type": "object",
        "description": "JSON:API single-resource response envelope for a subprocessor",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "type",
              "attributes"
            ],
            "properties": {
              "type": {
                "type": "string",
                "example": "subprocessors",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "$ref": "#/components/schemas/Subprocessor"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "SuccessEnvelope": {
        "type": "object",
        "required": [
          "data",
          "status"
        ],
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "success"
            ],
            "description": "Always the literal string 'success' for successful responses. This invariant is established here and must not be overridden by any operation's response schema."
          },
          "data": {
            "description": "Operation-specific payload. Overridden per-endpoint via allOf composition (e.g. PartyResponse = allOf:[SuccessEnvelope, {data: Party}]). A caller holding a bare SuccessEnvelope-typed reference sees data as unknown/Any \u2014 hold the op-specific composed type (e.g. PartyResponse) to get the typed data."
          },
          "message": {
            "type": "string",
            "description": "Optional human-readable message. Present when supplied by the API."
          },
          "meta": {
            "type": "object",
            "description": "Optional response metadata (pagination, request echo). Present when supplied by the API.",
            "additionalProperties": true
          },
          "links": {
            "type": "object",
            "description": "Optional hypermedia links. Present when supplied by the API.",
            "additionalProperties": true
          },
          "telemetry": {
            "$ref": "#/components/schemas/ResponseTelemetry"
          }
        },
        "additionalProperties": true
      },
      "SupportAgentContext": {
        "type": "object",
        "required": [
          "tenant_actor_id",
          "delegation_ref",
          "allowed_scopes",
          "operating_scope",
          "expires_at",
          "origin_chain_audit_ref"
        ],
        "properties": {
          "tenant_actor_id": {
            "type": "string",
            "x-axiom-identifier-classification": "tenant-actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "represented_principal": {
            "type": "string"
          },
          "delegation_ref": {
            "type": "string"
          },
          "allowed_scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "operating_scope": {
            "type": "string"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "revoked": {
            "type": "boolean"
          },
          "origin_chain_audit_ref": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "SupportAttachmentReference": {
        "type": "object",
        "required": [
          "reference_class",
          "custody_ref",
          "sha256",
          "classification",
          "admission_status",
          "redaction_status",
          "retention_ref"
        ],
        "properties": {
          "reference_class": {
            "type": "string",
            "enum": [
              "archive_object",
              "redacted_derivative",
              "communication_message",
              "support_session_disclosure",
              "audit_event",
              "gitlab_work_item",
              "council_record",
              "ci_release_evidence"
            ]
          },
          "custody_ref": {
            "type": "string"
          },
          "sha256": {
            "type": "string",
            "pattern": "^sha256:[0-9a-f]{16,64}$"
          },
          "classification": {
            "type": "string"
          },
          "admission_status": {
            "type": "string"
          },
          "redaction_status": {
            "type": "string"
          },
          "retention_ref": {
            "type": "string"
          },
          "legal_hold_ref": {
            "type": "string"
          },
          "derived_from": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "SupportRequest": {
        "type": "object",
        "required": [
          "request_id",
          "state",
          "request_class",
          "created_at",
          "updated_at",
          "tenant_or_account_scope",
          "visible_summary",
          "next_action",
          "allowed_actions",
          "support_access_status"
        ],
        "properties": {
          "request_id": {
            "type": "string",
            "x-axiom-identifier-classification": "request-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "state": {
            "type": "string",
            "enum": [
              "submitted",
              "triaged",
              "needs_information",
              "accepted",
              "declined",
              "support_access_requested",
              "support_access_approved",
              "converted_to_sdlc_intent",
              "in_progress",
              "resolved",
              "closed",
              "reopened"
            ]
          },
          "request_class": {
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "tenant_or_account_scope": {
            "type": "string"
          },
          "visible_summary": {
            "type": "string"
          },
          "next_action": {
            "type": "string"
          },
          "allowed_actions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "support_access_status": {
            "type": "string",
            "enum": [
              "not_requested",
              "requested",
              "approved",
              "declined",
              "expired",
              "ended",
              "revoked"
            ]
          },
          "support_session_disclosure_refs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "visible_support_session_ref": {
            "type": [
              "string",
              "null"
            ]
          },
          "support_access_expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "support_access_ended_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "links": {
            "type": "object",
            "additionalProperties": false
          },
          "audit_reference": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "affected_surface": {
            "type": "string"
          },
          "affected_canonical_noun": {
            "type": "string"
          },
          "affected_substrate": {
            "type": "string"
          },
          "requester_stated_severity": {
            "type": "string"
          },
          "kelevra_assigned_priority": {
            "type": "string"
          },
          "message_count": {
            "type": "integer"
          },
          "attachment_reference_count": {
            "type": "integer"
          },
          "retention_policy_ref": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "SupportRequestListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/SupportRequest"
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "has_more"
                ],
                "properties": {
                  "has_more": {
                    "type": "boolean"
                  },
                  "next_cursor": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "SupportRequestResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/SupportRequest"
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "SupportSession": {
        "type": "object",
        "required": [
          "support_session_id",
          "target_tenant_id",
          "reason",
          "purpose_code",
          "started_at",
          "expires_at"
        ],
        "properties": {
          "support_session_id": {
            "type": "string",
            "description": "The support session identifier (present this as X-Support-Session).",
            "x-axiom-identifier-classification": "support-session-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "target_tenant_id": {
            "type": "string",
            "description": "The target tenant the session is scoped to (typed-prefix tnt_\u2026 id).",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "reason": {
            "type": "string",
            "description": "The operator-supplied justification."
          },
          "purpose_code": {
            "type": "string",
            "description": "The closed named purpose (e.g. \"platform-support\")."
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the session was opened."
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "description": "Hard expiry; after this the session no longer admits."
          },
          "notified_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the target tenant was notified (present once notified)."
          },
          "ended_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the session was ended early (present once ended)."
          }
        },
        "additionalProperties": false
      },
      "SupportSessionDisclosureListResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/SupportSession"
                }
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "TrialBalance": {
        "type": "object",
        "description": "A trial balance over one tenant and one window, split by currency.\n\nTHREE POPULATION COUNTS, NOT ONE. `entries_considered` is what the window\nreturned; `entries_in_scope` is what the figures actually rest on; and\n`entries_excluded_unposted` is the difference attributable to unposted\nentries. A single total would let a reader mistake a narrow window for a\nsmall book, or a book of drafts for a balanced one.\n\n`balanced` AND `certified` ARE DIFFERENT STATEMENTS. `balanced` means every\ncurrency's debits equal its credits. `certified` additionally means the\npopulation supports that statement: a window whose entries were all unposted\nproduces balanced columns of zero, which is arithmetically true and\nworthless as a certification. When `certified` is false,\n`certification_detail` states why.\n",
        "properties": {
          "from": {
            "type": "string",
            "format": "date-time",
            "description": "Inclusive start of the business-time window.",
            "example": "2026-03-01T00:00:00Z"
          },
          "to": {
            "type": "string",
            "format": "date-time",
            "description": "Inclusive end of the business-time window.",
            "example": "2026-03-31T23:59:59Z"
          },
          "computed_at": {
            "type": "string",
            "format": "date-time",
            "description": "The as-at instant these figures were produced.",
            "example": "2026-04-01T06:00:00Z"
          },
          "by_currency": {
            "type": "array",
            "description": "One trial balance per currency, ordered by currency code.",
            "items": {
              "$ref": "#/components/schemas/TrialBalanceCurrency"
            }
          },
          "entries_considered": {
            "type": "integer",
            "description": "Entries the window returned, before the posted-only filter.",
            "example": 96
          },
          "entries_in_scope": {
            "type": "integer",
            "description": "Entries inside the window AND posted \u2014 the population the figures rest on.",
            "example": 84
          },
          "entries_excluded_unposted": {
            "type": "integer",
            "description": "Entries inside the window but not posted, and therefore excluded from every figure.",
            "example": 12
          },
          "entries_without_chart_link": {
            "type": "integer",
            "description": "In-scope entries written without a resolved `account_id`. **Non-zero makes\n`certified` false**: a balanced book is not a classified book.\n\nRead from `account_id`, which records chart resolution at write time and is\nnever backfilled \u2014 so adding a chart account later cannot retroactively make\nan unclassified entry appear classified. Such entries are immutable, so the\ndisposition is disclosure plus a compensating entry, never a backfill.\n\nThis is the only surface on which that population is measurable.\n",
            "example": 0
          },
          "balanced": {
            "type": "boolean",
            "description": "Whether debits equal credits in every currency.",
            "example": true
          },
          "certified": {
            "type": "boolean",
            "description": "Whether the balance statement is supported by the population it rests on.\nFalse when the columns do not agree, when the window's entries were all\nunposted, **or when any in-scope entry has no resolved `account_id`** \u2014 see\n`entries_without_chart_link`.\n",
            "example": false
          },
          "certification_detail": {
            "type": "string",
            "description": "Why the result is not certifiable. Absent when `certified` is true.",
            "example": "ledger: trial balance is balanced over 84 posted entries but 12 entries in the window were NOT POSTED and excluded; this is a balanced subset, not a balanced book"
          }
        },
        "required": [
          "from",
          "to",
          "computed_at",
          "by_currency",
          "entries_considered",
          "entries_in_scope",
          "entries_excluded_unposted",
          "balanced",
          "certified"
        ],
        "additionalProperties": false
      },
      "TrialBalanceAccount": {
        "type": "object",
        "description": "One account's two columns in one currency.\n\n`debit_minor` and `credit_minor` are reported separately and `net_minor` is\nderived from them. A single net figure cannot distinguish an account with no\nactivity from one whose debits and credits happen to cancel, and that\ndifference matters to whoever reads the book.\n",
        "properties": {
          "account_code": {
            "type": "string",
            "description": "Chart-of-accounts code.",
            "example": "ASSETS_CASH_BANK"
          },
          "debit_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Sum of debit magnitudes, exact integer minor units.",
            "example": 1250000
          },
          "credit_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Sum of credit magnitudes, exact integer minor units.",
            "example": 0
          },
          "net_minor": {
            "type": "integer",
            "format": "int64",
            "description": "Debits less credits, positive for a net debit balance. Derived, never the basis of the balance assertion.",
            "example": 1250000
          },
          "entry_count": {
            "type": "integer",
            "description": "Number of posted entries contributing to this account in this currency.",
            "example": 42
          },
          "entries_without_chart_link": {
            "type": "integer",
            "description": "How many of `entry_count` were written without a resolved `account_id` FK\nagainst this tenant's chart of accounts. Non-zero means this line's figures\nrest partly on entries whose `account_code` is persisted text matching no\nchart row the engine resolved \u2014 the line still balances and still totals,\nwhich is why the count is reported beside it rather than folded into it.\n",
            "example": 0
          }
        },
        "required": [
          "account_code",
          "debit_minor",
          "credit_minor",
          "net_minor",
          "entry_count"
        ],
        "additionalProperties": false
      },
      "TrialBalanceCurrency": {
        "type": "object",
        "description": "One currency's trial balance. Currencies are never summed across \u2014 a total\nmixing `zar` and `usd` is not a number.\n",
        "properties": {
          "currency_code": {
            "type": "string",
            "description": "Lowercase-canonical ISO 4217 code.",
            "example": "zar",
            "x-axiom-coded-value-classification": "iso-4217-currency-code"
          },
          "accounts": {
            "type": "array",
            "description": "Every account with at least one posted entry in scope, ordered by code.",
            "items": {
              "$ref": "#/components/schemas/TrialBalanceAccount"
            }
          },
          "total_debit_minor": {
            "type": "integer",
            "format": "int64",
            "example": 1250000
          },
          "total_credit_minor": {
            "type": "integer",
            "format": "int64",
            "example": 1250000
          },
          "entries_observed": {
            "type": "integer",
            "description": "The population this currency's figures rest on.",
            "example": 84
          },
          "balanced": {
            "type": "boolean",
            "description": "Whether this currency's debits equal its credits.",
            "example": true
          }
        },
        "required": [
          "currency_code",
          "accounts",
          "total_debit_minor",
          "total_credit_minor",
          "entries_observed",
          "balanced"
        ],
        "additionalProperties": false
      },
      "TrialBalanceResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "$ref": "#/components/schemas/TrialBalance"
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "UpdatePartyContactRequest": {
        "type": "object",
        "required": [
          "updated_by"
        ],
        "description": "Omitted values are preserved. Explicit false clears a flag; an empty contact_subtype clears the subtype. Contact type and owning party cannot be changed.",
        "properties": {
          "contact_subtype": {
            "type": "string"
          },
          "is_primary": {
            "type": "boolean"
          },
          "is_active": {
            "type": "boolean"
          },
          "contact_data": {
            "type": "object",
            "additionalProperties": true
          },
          "updated_by": {
            "type": "string",
            "description": "Required compatibility metadata; authenticated actor context supplies attribution."
          }
        },
        "additionalProperties": false
      },
      "UpdatePartyGroupRequest": {
        "type": "object",
        "description": "All fields optional; server updates only those supplied.",
        "properties": {
          "display_name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ]
          }
        },
        "additionalProperties": false
      },
      "UpdatePartyRequest": {
        "type": "object",
        "properties": {
          "supersedes_row_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^ptv_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Correct this currently-believed history row instead of changing validity going forward. Retains the target validity interval and appends a belief-time successor. External identifiers and merge targets cannot change in a correction. Omit for an ordinary update.",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "display_name": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "pattern": "\\S",
            "description": "Tenant-supplied display label, independent of legal-name attributes. Null means no name supplied. Omit on update to preserve the saved value; explicit null clears it. Changes are versioned for as-was replay.",
            "example": "Cedar Engineering (Pty) Ltd"
          },
          "external_id": {
            "type": "string",
            "description": "Replacement external identifier. If supplied, the effective source_system must be known and valid.",
            "example": "BRK-000124",
            "x-axiom-identifier-classification": "tenant-external-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "source_system": {
            "$ref": "#/components/schemas/PartyExternalIDSourceSystem"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Replacement party-specific attributes object. Omission preserves existing attributes.",
            "example": {
              "email": "maria.new-email@example.com",
              "phone": "+46701234567"
            }
          },
          "status": {
            "$ref": "#/components/schemas/PartyLifecycleStatus"
          },
          "merged_into_party_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Required when transitioning to status=merged; rejected for non-merged statuses.",
            "example": "pty_01j9zxkp8wqrm2n4v6t5s3d7f2",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "updated_by": {
            "type": "string",
            "description": "Identifier of the user or service performing the update",
            "example": "admin-user-002"
          }
        },
        "additionalProperties": false
      },
      "UpdateProductRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Updated display name",
            "example": "Motor TPL Enhanced"
          },
          "description": {
            "type": "string",
            "description": "Updated description"
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "suspended",
              "discontinued"
            ],
            "description": "Updated product lifecycle status. Status-only changes use the status-only persistence path and do not rewrite the cover graph."
          },
          "base_premium": {
            "type": "integer",
            "format": "int64",
            "description": "Base premium amount in the smallest currency unit.",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "attributes": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Updated extensible attributes."
          },
          "updated_by": {
            "type": "string",
            "deprecated": true,
            "description": "Retired compatibility field. Product update attribution is derived from the authenticated actor context.",
            "example": "usr_3f8a"
          }
        },
        "additionalProperties": false
      },
      "UpdateReserveRequest": {
        "type": "object",
        "required": [
          "amount"
        ],
        "properties": {
          "amount": {
            "type": "integer",
            "format": "int64",
            "minimum": 1,
            "description": "Replacement reserve amount in exact integer minor units.",
            "x-axiom-money-classification": "integer-minor-units-alpha-exception",
            "x-axiom-money-currency-association": "operation-or-tenant-currency-inherited-alpha",
            "x-axiom-money-migration-target": "#/components/schemas/Money"
          },
          "reason": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "UpdateSubprocessorRequest": {
        "type": "object",
        "description": "JSON:API envelope for subprocessor update request",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "example": "subprocessors",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Updated subprocessor name"
                  },
                  "service_scope": {
                    "type": "string",
                    "description": "Updated service scope description"
                  },
                  "change_reason": {
                    "type": "string",
                    "description": "Reason for non-approval metadata changes"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "UpdateVendorRequest": {
        "type": "object",
        "description": "JSON:API envelope for vendor update request",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "example": "vendors",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "type": "object",
                "description": "Partial vendor update. Only provided fields are modified.",
                "properties": {
                  "purpose": {
                    "type": "string",
                    "description": "Updated business purpose"
                  },
                  "classification": {
                    "type": "string",
                    "enum": [
                      "A",
                      "B",
                      "C",
                      "D",
                      "E"
                    ],
                    "description": "Optional compatibility assertion. The active\nvendor-classification ruleset computes the stored\nclassification from accessed_data_classes. If supplied, this\nvalue must match the ruleset-derived classification or the\nrequest fails with CLASSIFICATION_MISMATCH.\n"
                  },
                  "accessed_data_classes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Updated data classification labels"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "draft",
                      "onboarding",
                      "active",
                      "suspended",
                      "offboarded"
                    ],
                    "description": "Updated vendor status"
                  },
                  "integrations": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/CreateIntegrationInput"
                    },
                    "description": "Updated integrations list"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "UploadEventDocumentsRequest": {
        "type": "object",
        "description": "Multipart upload containing one to ten binary file parts, using any field\nnames. The complete request body is limited to 64 MiB. A request containing\nmore than ten file parts is rejected with HTTP 400 and canonical error code\n`INVALID_REQUEST`.\n",
        "minProperties": 1,
        "additionalProperties": {
          "type": "string",
          "format": "binary"
        }
      },
      "UploadEventDocumentsResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ingestAndLinkResultDTO"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "ValidationRule": {
        "type": "object",
        "required": [
          "rule_type",
          "value",
          "error_message"
        ],
        "properties": {
          "rule_type": {
            "type": "string",
            "enum": [
              "min",
              "max",
              "pattern",
              "required",
              "oneof"
            ],
            "description": "Type of validation to apply.\n- min: Minimum numeric value\n- max: Maximum numeric value\n- pattern: Regular expression the value must match\n- required: Value must be non-empty\n- oneof: Value must be one of a predefined set\n",
            "example": "min"
          },
          "value": {
            "description": "The validation constraint value (type depends on rule_type)",
            "example": 1
          },
          "error_message": {
            "type": "string",
            "description": "Human-readable error message when validation fails",
            "example": "Policy term must be at least 1 month"
          }
        },
        "additionalProperties": false
      },
      "Vendor": {
        "type": "object",
        "required": [
          "vendor_id",
          "name",
          "purpose",
          "classification",
          "accessed_data_classes",
          "status",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "vendor_id": {
            "type": "string",
            "readOnly": true,
            "description": "Unique vendor identifier",
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01",
            "format": "typed-prefix-id",
            "pattern": "^vnd_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "vendor-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "party_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional link to a Party record representing this vendor.\nWhen set, the vendor inherits contact and identity data from the Party.\n",
            "example": "vnd_01abcdefghjkmnpqrstvwxyz01"
          },
          "name": {
            "type": "string",
            "description": "Legal or trading name of the vendor",
            "example": "CloudSure Technologies (Pty) Ltd"
          },
          "purpose": {
            "type": "string",
            "description": "Business purpose for engaging this vendor\n(for example retained claim-family processing, payment gateway, document storage).\n",
            "example": "Cloud-based policy administration and document management"
          },
          "classification": {
            "type": "string",
            "enum": [
              "A",
              "B",
              "C",
              "D",
              "E"
            ],
            "readOnly": true,
            "description": "Vendor data-access classification (A-E) under the governed contract.\nThe active vendor-classification ruleset computes this value from\naccessed_data_classes; higher letters indicate more restrictive data\naccess.\n",
            "example": "B"
          },
          "accessed_data_classes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Data classification labels for data this vendor can access.\nUsed for POPIA/GDPR compliance tracking.\n",
            "example": [
              "personal_identifiable",
              "financial",
              "health"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "onboarding",
              "active",
              "suspended",
              "offboarded"
            ],
            "description": "Current lifecycle status of the vendor relationship.\n- draft: Initial vendor record created\n- onboarding: Vendor is being onboarded\n- active: Vendor is approved and operational\n- suspended: Vendor temporarily suspended pending investigation\n- offboarded: Vendor relationship has ended; integrations removed\n",
            "example": "active"
          },
          "integrations": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/Integration"
            },
            "description": "System integrations associated with this vendor"
          },
          "security_review_status": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "not_required",
              "pending",
              "approved",
              "rejected"
            ],
            "readOnly": true,
            "description": "Status of the most recent security review.\nChanged only through the authorized security-review decision workflow.\n- not_required: No security review needed for this vendor\n- pending: Security review is in progress\n- approved: Security review passed\n- rejected: Security review failed\n",
            "example": "approved"
          },
          "security_review_approved_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the security review was approved",
            "example": "2026-02-15T10:00:00Z"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the vendor record was created",
            "example": "2025-11-01T09:00:00Z"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "ISO 8601 timestamp when the vendor record was last updated",
            "example": "2026-03-05T16:20:00Z"
          }
        },
        "additionalProperties": false
      },
      "VendorDataEnvelope": {
        "type": "object",
        "description": "JSON:API single-resource response envelope for a vendor",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "type",
              "attributes"
            ],
            "properties": {
              "type": {
                "type": "string",
                "example": "vendors",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "$ref": "#/components/schemas/Vendor"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "VendorSecurityReviewDecisionRequest": {
        "type": "object",
        "description": "JSON:API envelope for an authorized vendor security-review decision",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "type",
              "attributes"
            ],
            "properties": {
              "type": {
                "type": "string",
                "example": "vendor-security-review-decisions",
                "x-axiom-coded-value-classification": "tenant-catalogue-type"
              },
              "attributes": {
                "type": "object",
                "required": [
                  "status",
                  "decision_basis"
                ],
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "not_required",
                      "pending",
                      "approved",
                      "rejected"
                    ],
                    "description": "New security-review status decided by an authorized actor",
                    "example": "approved"
                  },
                  "decision_basis": {
                    "type": "string",
                    "description": "Human-readable basis for the attestation decision",
                    "example": "SOC 2 Type II report and security questionnaire reviewed"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "VerifyEvidenceResponse": {
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/VerifyEvidenceResult"
                }
              }
            },
            "required": [
              "data"
            ],
            "additionalProperties": true
          }
        ]
      },
      "VerifyEvidenceResult": {
        "type": "object",
        "required": [
          "record_id",
          "content_hash",
          "status"
        ],
        "properties": {
          "record_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "example": "evd_01K4Q5JD4AF6Z5PQV0DJD9XQ8M",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "content_hash": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "VERIFIED",
              "TAMPERED",
              "MISSING",
              "CORRECTED"
            ]
          },
          "details": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "VerifyIntegrityRequest": {
        "type": "object",
        "required": [
          "entry_ids"
        ],
        "description": "Entries to verify. `entry_ids` is REQUIRED and bounded: a request with an\nempty, absent or over-long list is rejected with `400 INVALID_REQUEST`.\n\nThis operation verifies the entries you name. It does not discover entries,\nand it cannot report on a population you did not enumerate \u2014 see the\noperation description for what that means for an attestation.\n",
        "properties": {
          "entry_ids": {
            "type": "array",
            "minItems": 1,
            "maxItems": 1000,
            "items": {
              "type": "string"
            },
            "description": "Ledger entry ids to verify, 1..1000 per request. Required.\n",
            "example": [
              "01J8Z2K4P7Q9R1S3T5V7W9X1Y3"
            ]
          },
          "include_chain": {
            "type": "boolean",
            "default": true,
            "description": "Follow each entry's `original_entry_id` lineage and verify every ancestor\nas well. Defaults to **true** when omitted. With chain traversal off, a\ntampered ancestor of an intact entry is not detected.\n",
            "example": true
          },
          "as_of_time": {
            "type": "string",
            "format": "date-time",
            "description": "Optional cutoff. An entry whose processing timestamp is after this\ninstant is reported `OUT_OF_WINDOW` rather than verified.\n",
            "example": "2026-03-31T23:59:59Z"
          }
        },
        "additionalProperties": false
      },
      "VerifyIntegrityResponse": {
        "type": "object",
        "required": [
          "results"
        ],
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IntegrityResult"
            }
          }
        },
        "additionalProperties": false
      },
      "WithdrawConsentGrantRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "withdrawn_at",
          "reason"
        ],
        "properties": {
          "withdrawn_at": {
            "type": "string",
            "format": "date-time",
            "description": "Not before the grant's `valid_from` and not after the recording instant."
          },
          "reason": {
            "type": "string",
            "minLength": 1
          }
        }
      },
      "WorkbenchEditAuthorizationDecisionRef": {
        "type": "object",
        "description": "Tenant-keyed follow-on read reference for the authorization decision evidence behind a application edit.",
        "required": [
          "kind",
          "correlation_id",
          "href"
        ],
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "access_decision_by_correlation"
            ]
          },
          "correlation_id": {
            "type": "string",
            "description": "Request correlation id used to resolve access-decision evidence.",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "href": {
            "type": "string",
            "description": "Relative operator API href for the tenant-keyed access-decision read."
          }
        },
        "additionalProperties": false
      },
      "WorkbenchEditReceipt": {
        "type": "object",
        "description": "Server-authored evidence receipt metadata for a successful application 4A edit write.",
        "required": [
          "operation_id",
          "object_type",
          "object_id",
          "actor_type",
          "actor_id",
          "authorization_decision_ref",
          "correlation_id",
          "request_id",
          "recorded_at"
        ],
        "properties": {
          "operation_id": {
            "type": "string",
            "description": "OpenAPI operationId for the write that produced this receipt.",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "object_type": {
            "type": "string",
            "description": "Stable object family label for receipt rendering."
          },
          "object_id": {
            "type": "string",
            "description": "Mutated object identifier in the handler's canonical wire form.",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "on_behalf_of_tenant_id": {
            "type": "string",
            "description": "Server-resolved on-behalf-of tenant, when distinct and available.",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "actor_type": {
            "type": "string",
            "description": "Server-resolved actor type."
          },
          "actor_id": {
            "type": "string",
            "description": "Server-resolved acting account/service id.",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "description": "Original actor id where impersonation/delegation resolution produced one.",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "support_session_id": {
            "type": "string",
            "description": "Support-session id observed by the server, when present.",
            "x-axiom-identifier-classification": "support-session-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "authorization_decision_ref": {
            "$ref": "#/components/schemas/WorkbenchEditAuthorizationDecisionRef"
          },
          "correlation_id": {
            "type": "string",
            "description": "governed contract request correlation id.",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "request_id": {
            "type": "string",
            "description": "Gateway request id.",
            "x-axiom-identifier-classification": "request-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "Server time when the receipt was emitted."
          },
          "evidence_refs": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Additional durable evidence ids, when a write path already exposes them."
          },
          "links": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Operator follow-on links for receipt inspection."
          }
        },
        "additionalProperties": false
      },
      "WorkbenchEditReceiptMeta": {
        "type": "object",
        "description": "Optional response meta block present on successful application 4A edit writes.",
        "required": [
          "workbench_edit_receipt"
        ],
        "properties": {
          "workbench_edit_receipt": {
            "$ref": "#/components/schemas/WorkbenchEditReceipt"
          }
        },
        "additionalProperties": false
      },
      "Workroom": {
        "type": "object",
        "required": [
          "workroom_id",
          "title",
          "kind",
          "state",
          "owner_actor_id",
          "created_by_actor_id",
          "created_at",
          "updated_at",
          "folder_id",
          "hidden",
          "left",
          "latest_session_id",
          "latest_event_id"
        ],
        "properties": {
          "workroom_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "title": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "general",
              "shared",
              "private"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "open",
              "paused",
              "blocked",
              "closing",
              "closed"
            ]
          },
          "owner_actor_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "created_by_actor_id": {
            "type": "string",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "folder_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "hidden": {
            "type": "boolean"
          },
          "left": {
            "type": "boolean"
          },
          "latest_session_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "latest_event_id": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "WorkroomListResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "workrooms",
              "has_more",
              "next_cursor"
            ],
            "properties": {
              "workrooms": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/Workroom"
                }
              },
              "has_more": {
                "type": "boolean"
              },
              "next_cursor": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "WorkroomMember": {
        "type": "object",
        "required": [
          "workroom_id",
          "identity_id",
          "role",
          "joined_at"
        ],
        "properties": {
          "workroom_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "identity_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "role": {
            "$ref": "#/components/schemas/WorkroomRole"
          },
          "joined_at": {
            "type": "string",
            "format": "date-time"
          },
          "left_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "WorkroomMemberListResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "members",
              "can_manage_members"
            ],
            "properties": {
              "members": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/WorkroomMember"
                }
              },
              "current_user_role": {
                "$ref": "#/components/schemas/WorkroomRole"
              },
              "can_manage_members": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "WorkroomMemberMutationRequest": {
        "type": "object",
        "required": [
          "identity_id",
          "role"
        ],
        "properties": {
          "identity_id": {
            "type": "string",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "role": {
            "$ref": "#/components/schemas/WorkroomRole"
          }
        },
        "additionalProperties": false
      },
      "WorkroomMemberResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "member"
            ],
            "properties": {
              "member": {
                "$ref": "#/components/schemas/WorkroomMember"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "WorkroomResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "type": "object",
            "required": [
              "workroom"
            ],
            "properties": {
              "workroom": {
                "$ref": "#/components/schemas/Workroom"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "WorkroomRole": {
        "type": "string",
        "enum": [
          "owner",
          "admin",
          "editor",
          "contributor",
          "viewer",
          "guest"
        ]
      },
      "archiveObjectDTO": {
        "type": "object",
        "description": "Archived-object descriptor returned by the archive service Ingest.\nShape is service-defined; common fields documented below.\n",
        "additionalProperties": true,
        "properties": {
          "id": {
            "type": "string",
            "x-axiom-identifier-classification": "archive-object-id",
            "x-axiom-identifier-shape": "opaque-string",
            "description": "Archive object identifier."
          },
          "object_uri": {
            "type": "string",
            "description": "Canonical storage URI."
          },
          "content_hash": {
            "type": "string",
            "description": "Content hash of the stored payload."
          },
          "mime_type": {
            "type": "string"
          },
          "original_filename": {
            "type": "string"
          },
          "size_bytes": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "biTemporalEntryDTO": {
        "type": "object",
        "description": "Wire shape for a single bi-temporal catalogue entry.\n\nEntity identifiers are support-visible typed-prefix wire IDs on create,\nlist, point-read, and supersede responses:\n`id` uses the `cae_` prefix, `catalogue_id` uses `cat_`, and\n`source_provenance_id` uses `spv_` when present.\n",
        "required": [
          "id",
          "logical_entry_id",
          "catalogue_id",
          "code",
          "description",
          "status",
          "valid_from",
          "recorded_at",
          "asserted_from"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Physical row identifier rendered as a `cae_` typed-prefix wire ID.\n",
            "example": "cae_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "logical_entry_id": {
            "type": "string",
            "description": "Stable `cei_` typed-prefix identity that groups all bi-temporal versions\nof the same logical code.\n",
            "example": "cei_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "catalogue-logical-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "catalogue_id": {
            "type": "string",
            "description": "Parent catalogue identifier rendered as a `cat_` typed-prefix wire ID.\n",
            "example": "cat_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "code": {
            "type": "string",
            "description": "The canonical lookup code for this entry (e.g. `J18.9`, `703157`).",
            "example": "J18.9",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "description": {
            "type": "string",
            "description": "Human-readable description of the entry.",
            "example": "Pneumonia, unspecified organism"
          },
          "status": {
            "type": "string",
            "description": "Lifecycle status of this entry version (e.g. `active`, `retired`).",
            "example": "active",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-defined JSONB attributes for this entry. Shape is catalogue-specific\nand governed by the Catalogue Descriptor's attribute declarations (governed contract).\n"
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Start of the real-world validity window for this entry version (RFC 3339).\n",
            "example": "2026-01-01T00:00:00Z"
          },
          "valid_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "End of the real-world validity window. Omitted when the entry version is\nopen-ended (valid_to IS NULL in storage). Populated after a supersede\noperation closes this version.\n",
            "example": "2026-12-31T23:59:59Z"
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "Start of the belief (assertion) window (RFC3339)."
          },
          "asserted_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Exclusive end of the belief window; omitted for current belief."
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "Immutable physical-anchor timestamp (RFC 3339). Set by the persistence-managed records at\nINSERT time; never settable by callers (governed contract recorded_at axis).\n",
            "example": "2026-01-15T08:00:00Z"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Source-provenance record identifier rendered as an `spv_` typed-prefix\nwire ID. Omitted when no provenance record is linked.\n",
            "example": "spv_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "meta": {
            "$ref": "#/components/schemas/WorkbenchEditReceiptMeta"
          }
        },
        "additionalProperties": false
      },
      "biTemporalEntryHistoryDTO": {
        "type": "object",
        "description": "Full-history catalogue entry DTO (GET .../entries/history). Carries ALL\nFIVE bi-temporal axes (governed contract) on every row plus the server-computed\nis_current flag \u2014 the entry-identity analogue of biTemporalTVHistoryDTO.\n",
        "properties": {
          "id": {
            "type": "string",
            "description": "Typed-prefix ID of this catalogue entry (cat_ent_ prefix via renderCatalogueEntryID).",
            "example": "cat_ent_01j9zxampleentry",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "logical_entry_id": {
            "type": "string",
            "description": "Logical entry reference whose supersede chain this row belongs to.",
            "x-axiom-identifier-classification": "catalogue-logical-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "catalogue_id": {
            "type": "string",
            "description": "Typed-prefix ID of the parent catalogue (cat_ prefix via renderCatalogueID).",
            "example": "cat_01j9zxamplecatalogue",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "code": {
            "type": "string",
            "example": "1193493001",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "description": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "example": "active",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Per-version JSONB attributes (e.g. {\"manufacturer\": \"AspenPharma\"})."
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of real-world validity window."
          },
          "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of validity; omitted for the open-ended (latest) version."
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of the belief window (when this was asserted)."
          },
          "asserted_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of the belief window; omitted for a currently-believed version."
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "Immutable physical anchor \u2014 persistence-managed records-enforced row-creation timestamp."
          },
          "is_current": {
            "type": "boolean",
            "description": "True for the version the point-in-time reader returns at as_of=now (valid window contains now AND belief window open)."
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Typed-prefix ID (spv_ prefix) of the source-provenance record, when set.",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "biTemporalEntryHistoryListResponse": {
        "type": "object",
        "x-items-field": "entries",
        "description": "Envelope for GET /v1/catalogues/{catalogue-ref}/entries/history.\nCursor-paginated: next_cursor is empty when there is no further page.\nMatches response object{\"entries\",\"count\",\"has_more\",\"next_cursor\"}.\nx-items-field marks this as a KEYSET (cursor) list response so the SDK\ngenerator routes its operations to paginateKeyset (meta.next_cursor -> page[after]),\nNOT the offset auto-pager.\n",
        "required": [
          "entries",
          "count",
          "has_more"
        ],
        "properties": {
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/biTemporalEntryHistoryDTO"
            },
            "description": "This page of history rows, ordered valid_from ASC."
          },
          "count": {
            "type": "integer",
            "description": "Number of rows in this page (not a grand total)."
          },
          "has_more": {
            "type": "boolean",
            "description": "True when a further page exists (fetch it with next_cursor)."
          },
          "next_cursor": {
            "type": "string",
            "description": "Opaque keyset cursor for the next page; empty when has_more is false."
          }
        },
        "additionalProperties": false
      },
      "biTemporalEntryListResponse": {
        "description": "One bounded page; no cursor and no automatic traversal.",
        "allOf": [
          {
            "$ref": "#/components/schemas/SuccessEnvelope"
          },
          {
            "type": "object",
            "required": [
              "data",
              "meta"
            ],
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/biTemporalEntryDTO"
                }
              },
              "meta": {
                "type": "object",
                "required": [
                  "page",
                  "query"
                ],
                "properties": {
                  "page": {
                    "type": "object",
                    "required": [
                      "limit",
                      "has_more"
                    ],
                    "properties": {
                      "limit": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "has_more": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": false
                  },
                  "query": {
                    "type": "object",
                    "required": [
                      "descriptor_fingerprint",
                      "comparator_version",
                      "valid_at",
                      "asserted_at",
                      "ordering"
                    ],
                    "properties": {
                      "descriptor_id": {
                        "type": "string",
                        "x-axiom-identifier-classification": "opaque-resource-id",
                        "x-axiom-identifier-shape": "alpha-exception",
                        "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
                      },
                      "descriptor_version": {
                        "type": "integer"
                      },
                      "descriptor_fingerprint": {
                        "type": "string"
                      },
                      "comparator_version": {
                        "type": "string"
                      },
                      "valid_at": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "asserted_at": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "field_definitions": {
                        "type": "object",
                        "additionalProperties": {
                          "type": "object",
                          "additionalProperties": true
                        },
                        "description": "Frozen definitions of fields used by this query, without operands."
                      },
                      "ordering": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": true
          }
        ]
      },
      "biTemporalRelationshipDTO": {
        "type": "object",
        "description": "Relationship DTO returned by POST and included in GET list responses.\nid uses car_ typed-prefix; relationship_type_entity_id uses crp_ prefix;\nsource_catalogue_entity_id and target_catalogue_entity_id use cat_ prefix;\n  source_provenance_id uses spv_ prefix when present.\n  logical_relationship_id uses car_; source_logical_entry_id and\n  target_logical_entry_id use cei_.\n",
        "properties": {
          "id": {
            "type": "string",
            "description": "Typed-prefix ID of this relationship (car_ prefix).",
            "example": "car_01j9zxamplerelationship",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "logical_relationship_id": {
            "type": "string",
            "description": "car_ logical relationship identity, client-supplied or server-generated.",
            "example": "car_01j9zxamplerelationship",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "relationship_type_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the catalogue relationship-type record (crp_ prefix).",
            "example": "crp_01j9zxamplereltype",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "source_catalogue_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the source catalogue (cat_ prefix).",
            "example": "cat_01j9zxamplesrccatalogue",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "source_logical_entry_id": {
            "type": "string",
            "description": "Logical source bi-temporal entry reference.",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "source_code": {
            "type": "string",
            "description": "Code of the source entry at relationship creation time.",
            "example": "N000123"
          },
          "target_catalogue_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the target catalogue (cat_ prefix).",
            "example": "cat_01j9zxampletgtcatalogue",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "target_logical_entry_id": {
            "type": "string",
            "description": "Logical target bi-temporal entry reference.",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "target_code": {
            "type": "string",
            "description": "Code of the target entry at relationship creation time.",
            "example": "ATC-J01CA04"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Optional JSONB attributes for this relationship.",
            "example": {
              "strength": "500mg",
              "form": "tablet"
            }
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of real-world validity window.",
            "example": "2024-01-01T00:00:00Z"
          },
          "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of validity; omitted for open-ended windows.",
            "example": "2025-01-01T00:00:00Z"
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "Beginning of the tenant assertion window.",
            "example": "2024-06-01T10:00:00Z"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Typed-prefix ID of the source-provenance record (spv_ prefix) when set.",
            "example": "spv_01j9zxampleprovenance",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "asserted_to": {
            "type": "string",
            "format": "date-time",
            "description": "Exclusive end of the assertion window; omitted when open."
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "Immutable physical recording anchor; never a query axis.",
            "example": "2024-06-01T10:00:00Z"
          }
        },
        "additionalProperties": false
      },
      "biTemporalRelationshipListResponse": {
        "type": "object",
        "x-items-field": "relationships",
        "description": "Envelope for GET /v1/catalogues/{catalogue-ref}/relationships list responses.\nKey is `relationships` matching the runtime response object{\"relationships\": dtos, \"count\": N}\nat runtime source listBiTemporalRelationshipsHandler.\nx-items-field tells the SDK generator the rows live under `relationships`,\nNOT `data` \u2014 so it emits the named-field reader, not the offset auto-pager\n(which reads `data` and would silently return zero rows). Point-in-time\nsingle page: `count` only, no `has_more`/`next_cursor`.\n",
        "required": [
          "relationships",
          "count"
        ],
        "properties": {
          "relationships": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/biTemporalRelationshipDTO"
            },
            "description": "Array of matching bi-temporal relationship DTOs."
          },
          "count": {
            "type": "integer",
            "description": "Total number of relationships returned (same as len(relationships); not a paged total).",
            "example": 3
          }
        },
        "additionalProperties": false
      },
      "biTemporalTVDTO": {
        "type": "object",
        "description": "Temporal value DTO returned by POST and included in GET list responses.\nid uses renderTemporalValueID (tmv_ typed-prefix).\nsource_provenance_id uses renderSourceProvenanceID (spv_ typed-prefix) when present.\n",
        "properties": {
          "id": {
            "type": "string",
            "description": "Typed-prefix ID of this temporal value (tmv_ prefix via renderTemporalValueID).",
            "example": "tmv_01j9zxampletemporalvalue",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "logical_entry_id": {
            "type": "string",
            "description": "Logical parent bi-temporal entry reference.",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "catalogue-logical-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "code": {
            "type": "string",
            "description": "Short code for this temporal value.",
            "example": "sep_price",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "value_type": {
            "type": "string",
            "description": "Discriminator for the value JSONB shape.",
            "example": "money",
            "x-axiom-coded-value-classification": "tenant-catalogue-value-type"
          },
          "value": {
            "type": "object",
            "additionalProperties": true,
            "description": "JSONB payload; shape governed by value_type discriminator. May be omitted for some value types.",
            "example": {
              "amount": "267.00",
              "currency_code": "zar"
            }
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of real-world validity window.",
            "example": "2024-01-01T00:00:00Z"
          },
          "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of validity; omitted for open-ended windows.",
            "example": "2025-01-01T00:00:00Z"
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of the belief (assertion) window \u2014 when Axiom began believing this value (governed contract).",
            "example": "2024-06-01T10:00:00Z"
          },
          "asserted_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of the belief window; omitted for the currently-believed (open) window. Exposed on the point-in-time reader under the governed contract (\u00a7update 2026-06-06).",
            "example": "2024-09-01T10:00:00Z"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "Immutable physical anchor \u2014 persistence-managed records-enforced timestamp of row creation.",
            "example": "2024-06-01T10:00:00Z"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Typed-prefix ID of the source-provenance record (spv_ prefix) when set.",
            "example": "spv_01j9zxampleprovenance",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "meta": {
            "$ref": "#/components/schemas/WorkbenchEditReceiptMeta"
          }
        },
        "additionalProperties": false
      },
      "biTemporalTVHistoryDTO": {
        "type": "object",
        "description": "Full-history temporal value DTO (GET .../temporal-values/history). Carries\nALL FIVE bi-temporal axes (governed contract) on every row plus the server-computed\nis_current flag \u2014 so the shape never locks out belief-axis or full-rectangle\nreads.\n",
        "properties": {
          "id": {
            "type": "string",
            "description": "Typed-prefix ID of this temporal value (tmv_ prefix).",
            "example": "tmv_01j9zxampletemporalvalue",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "logical_entry_id": {
            "type": "string",
            "description": "Logical parent bi-temporal entry reference.",
            "x-axiom-identifier-classification": "catalogue-logical-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "code": {
            "type": "string",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "value_type": {
            "type": "string",
            "example": "gems_tariff_amount",
            "x-axiom-coded-value-classification": "tenant-catalogue-value-type"
          },
          "value": {
            "type": "object",
            "additionalProperties": true,
            "description": "JSONB payload; shape governed by value_type discriminator.",
            "example": {
              "amount_minor": 53280,
              "currency_code": "zar",
              "as_published": "532.80"
            }
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of real-world validity window."
          },
          "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of validity; omitted for the open-ended (latest) version."
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of the belief window (when this was asserted)."
          },
          "asserted_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of the belief window; omitted for a currently-believed value."
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "description": "Immutable physical anchor \u2014 persistence-managed records-enforced row-creation timestamp."
          },
          "is_current": {
            "type": "boolean",
            "description": "True for the version the point-in-time reader returns at as_of=now (valid window contains now AND belief window open)."
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Typed-prefix ID (spv_ prefix) of the source-provenance record, when set.",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "biTemporalTVHistoryListResponse": {
        "type": "object",
        "x-items-field": "temporal_values",
        "description": "Envelope for GET /v1/catalogues/{catalogue-ref}/temporal-values/history.\nCursor-paginated: next_cursor is empty when there is no further page.\nMatches response object{\"temporal_values\",\"count\",\"has_more\",\"next_cursor\"}.\nx-items-field marks this as a KEYSET (cursor) list response so the SDK\ngenerator routes its operations to paginateKeyset (meta.next_cursor -> page[after]),\nNOT the offset auto-pager \u2014 the offset pager would silently return page 1\nonly (no offset on a keyset envelope).\n",
        "required": [
          "temporal_values",
          "count",
          "has_more"
        ],
        "properties": {
          "temporal_values": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/biTemporalTVHistoryDTO"
            },
            "description": "This page of history rows, ordered valid_from ASC."
          },
          "count": {
            "type": "integer",
            "description": "Number of rows in this page (not a grand total)."
          },
          "has_more": {
            "type": "boolean",
            "description": "True when a further page exists (fetch it with next_cursor)."
          },
          "next_cursor": {
            "type": "string",
            "description": "Opaque keyset cursor for the next page; empty when has_more is false."
          }
        },
        "additionalProperties": false
      },
      "biTemporalTVListResponse": {
        "type": "object",
        "x-items-field": "temporal_values",
        "description": "Envelope for GET /v1/catalogues/{catalogue-ref}/temporal-values list responses.\nKey is `temporal_values` matching the runtime response object{\"temporal_values\": dtos, \"count\": N}\nat runtime source listBiTemporalTVHandler.\nx-items-field tells the SDK generator the rows live under `temporal_values`,\nNOT `data` \u2014 so it emits the named-field reader, not the offset auto-pager\n(which reads `data` and would silently return zero rows). Point-in-time\nsingle page: `count` only, no `has_more`/`next_cursor`.\n",
        "required": [
          "temporal_values",
          "count"
        ],
        "properties": {
          "temporal_values": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/biTemporalTVDTO"
            },
            "description": "Array of matching bi-temporal temporal value DTOs."
          },
          "count": {
            "type": "integer",
            "description": "Total number of temporal values returned (same as len(temporal_values); not a paged total).",
            "example": 7
          }
        },
        "additionalProperties": false
      },
      "catalogueBulkWriteRequest": {
        "type": "object",
        "description": "Request body for POST /v1/catalogues/{catalogue-ref}/bulk-write.\nEnqueues an async catalogue ingestion job from a previously-uploaded file.\nruntime source catalogueBulkWriteHandler returns 202 Accepted.\n",
        "required": [
          "schema_version",
          "upload_id",
          "snapshot_date"
        ],
        "properties": {
          "schema_version": {
            "type": "integer",
            "description": "Must be 1; other values are rejected 400 UNSUPPORTED_SCHEMA_VERSION.",
            "example": 1
          },
          "upload_id": {
            "type": "string",
            "description": "Opaque upload reference for the previously uploaded file blob to ingest.",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "snapshot_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 effective date for the snapshot being ingested.",
            "example": "2024-03-31T00:00:00Z"
          },
          "label_name": {
            "type": "string",
            "description": "Optional snapshot label to stamp after successful ingestion.",
            "example": "2024-contract rule-release"
          },
          "expected_row_count": {
            "type": "integer",
            "description": "Optional row count for pre-ingestion validation; mismatch returns 422.",
            "example": 150000
          },
          "checksum_sha256": {
            "type": "string",
            "description": "Optional SHA-256 hex digest of the upload for integrity verification.",
            "example": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
          }
        },
        "additionalProperties": false
      },
      "catalogueBulkWriteResponse": {
        "type": "object",
        "description": "Response envelope for POST /v1/catalogues/{catalogue-ref}/bulk-write (202 Accepted).\nReturns a job_id for polling and an initial status of \"queued\".\nruntime source catalogueBulkWriteHandler.\n",
        "required": [
          "job_id",
          "status"
        ],
        "properties": {
          "job_id": {
            "type": "string",
            "pattern": "^job_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed work-item job identifier; use for polling job status.",
            "example": "job_00000000000000000000000456",
            "format": "typed-prefix-id",
            "x-axiom-identifier-classification": "work-item-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "status": {
            "type": "string",
            "description": "Initial job status; always \"queued\" on 202 response.",
            "example": "queued",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          }
        },
        "additionalProperties": false
      },
      "catalogueDTO": {
        "type": "object",
        "required": [
          "id",
          "slug",
          "name",
          "source",
          "refresh_frequency",
          "created_at",
          "updated_at",
          "substrate",
          "has_descriptor"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Server-assigned `cat_` typed-prefix catalogue ID.",
            "example": "cat_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "slug": {
            "type": "string",
            "description": "Human-friendly stable identifier used in URL paths (e.g. `icd-10-za`)."
          },
          "name": {
            "type": "string",
            "description": "Human-readable display name."
          },
          "source": {
            "type": "string",
            "description": "Upstream data authority (e.g. `WHO/DoH-ZA`, `BHF`)."
          },
          "refresh_frequency": {
            "type": "string",
            "description": "Declared refresh cadence (e.g. `annual`, `monthly`, `quarterly`)."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Row creation timestamp (RFC 3339)."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last mutation timestamp (RFC 3339)."
          },
          "substrate": {
            "type": "string",
            "enum": [
              "bi-temporal"
            ],
            "description": "The catalogue's storage substrate. Always `bi-temporal` now that the\nEdition/CatalogueVersion model is retired (governed contract). Surfaced as an\nenum (not a bool) for forward-safety. Lets a client choose its read\npath without probing the retired `GET .../versions` route.\n"
          },
          "has_descriptor": {
            "type": "boolean",
            "description": "True when a Catalogue Descriptor (governed contract) is stamped for this\ncatalogue. Pre-resolved via a single batched presence lookup so a\nclient never probes `GET .../descriptor` and reads meaning from a 404.\n"
          },
          "descriptor_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The stamped `cde_` typed-prefix descriptor ID; omitted when\nhas_descriptor is false.\n",
            "example": "cde_01j1234567890abcdefghijk"
          },
          "discarded_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Soft-discard timestamp; omitted on live parents."
          },
          "discarded_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "Actor identifier that performed the discard; omitted on live parents."
          },
          "discard_reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Human-intelligible discard justification; omitted on live parents."
          }
        },
        "additionalProperties": false
      },
      "catalogueLabelDTO": {
        "type": "object",
        "description": "Representation of a catalogue snapshot label.\nReturned by POST /v1/catalogues/{catalogue-ref}/labels (201 Created)\nand items in GET /v1/catalogues/{catalogue-ref}/labels list.\nid uses the `cal_` typed-prefix wire form; catalogue_id uses `cat_`;\nsource_provenance_id uses `spv_` when present.\n",
        "required": [
          "id",
          "catalogue_id",
          "label_name",
          "as_of_date",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Typed-prefix ID of the catalogue label row.",
            "example": "cal_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "catalogue_id": {
            "type": "string",
            "description": "Typed-prefix ID of the parent catalogue.",
            "example": "cat_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "label_name": {
            "type": "string",
            "description": "Snapshot label name.",
            "example": "2024-contract rule-release"
          },
          "as_of_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 point-in-time the label is anchored to.",
            "example": "2024-03-31T00:00:00Z"
          },
          "description": {
            "type": "string",
            "description": "Optional free-text description.",
            "example": "contract rule 2024 formulary snapshot"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Typed-prefix ID of the associated source-provenance record (spv_ prefix), when set.",
            "example": "spv_01j9zxampleprovenance",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 creation timestamp.",
            "example": "2024-06-01T10:00:00Z"
          },
          "created_by": {
            "type": "string",
            "description": "Actor ID that created the label, when available.",
            "example": "usr_01j9zxampleactor"
          }
        },
        "additionalProperties": false
      },
      "catalogueLabelListResponse": {
        "type": "object",
        "description": "Envelope for GET /v1/catalogues/{catalogue-ref}/labels list responses.\nKey is `labels` matching the runtime response object{\"labels\": dtos, \"count\": N}\nat runtime source listCatalogueLabelsHandler.\n",
        "required": [
          "labels",
          "count"
        ],
        "properties": {
          "labels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/catalogueLabelDTO"
            },
            "description": "Array of catalogue label DTOs."
          },
          "count": {
            "type": "integer",
            "description": "Number of labels returned.",
            "example": 2
          }
        },
        "additionalProperties": false
      },
      "catalogueListResponse": {
        "type": "object",
        "required": [
          "data",
          "meta"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/catalogueDTO"
            }
          },
          "meta": {
            "type": "object",
            "required": [
              "limit",
              "offset",
              "count"
            ],
            "properties": {
              "limit": {
                "type": "integer"
              },
              "offset": {
                "type": "integer"
              },
              "count": {
                "type": "integer"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "catalogueSingleResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/catalogueDTO"
          },
          "meta": {
            "$ref": "#/components/schemas/WorkbenchEditReceiptMeta"
          }
        },
        "additionalProperties": false
      },
      "createBiTemporalEntryRequest": {
        "type": "object",
        "description": "Request body for POST /v1/catalogues/{catalogue-ref}/entries.\nCreates a new logical entry (when `logical_entry_id` is omitted the server\ngenerates a UUID) or a new bi-temporal version of an existing logical entry\n(caller supplies a prior `logical_entry_id` with a strictly-later `valid_from`).\n",
        "required": [
          "code",
          "description",
          "valid_from"
        ],
        "properties": {
          "logical_entry_id": {
            "type": "string",
            "description": "Optional. If supplied, pins this version to an existing logical entry.\nIf omitted, the server generates a new UUID creating a brand-new logical entry.\n",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "catalogue-logical-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "code": {
            "type": "string",
            "description": "The canonical lookup code (e.g. `J18.9`, `703157`). Required.",
            "example": "J18.9",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "description": {
            "type": "string",
            "description": "Human-readable description of the entry. Required.",
            "example": "Pneumonia, unspecified organism"
          },
          "status": {
            "type": "string",
            "description": "Lifecycle status. Defaults to `active` when omitted.\n",
            "example": "active",
            "x-axiom-coded-value-classification": "tenant-lifecycle-status"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Tenant-defined JSONB attributes. Shape is catalogue-specific."
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Start of the real-world validity window (RFC 3339). Required.",
            "example": "2026-01-01T00:00:00Z"
          },
          "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Optional end of the real-world validity window (RFC 3339). Omit for an\nopen-ended entry.\n",
            "example": "2026-12-31T23:59:59Z"
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "Optional caller-owned start of the belief (assertion) window (RFC 3339,\nexplicit timezone). The belief axis is settable under the governed contract \u2014 supply it\nto import a historical belief window on tenant take-on, or to record an\nas-was correction. Omitted \u2192 the server defaults asserted_from to now().\n",
            "example": "2024-01-01T00:00:00Z"
          },
          "asserted_to": {
            "type": "string",
            "format": "date-time",
            "description": "Optional end of the belief (assertion) window (RFC 3339, explicit\ntimezone). Omitted \u2192 open belief window (the current belief). When\nsupplied it must be strictly after `asserted_from`, and `asserted_from`\nmust also be supplied.\n",
            "example": "2024-03-01T00:00:00Z"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Optional advanced override \u2014 link this row to an existing\nsource-provenance record (e.g. a bulk-load run). When omitted, the\nserver auto-creates a `direct`-kind source-provenance row derived\nfrom the authenticated actor, request time, and X-Correlation-ID;\nthe entry/TV/relationship always traces to a provenance row. A\nsupplied id that does not resolve under the operating tenant\nreturns 404.\n",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "source-provenance-reference",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          }
        },
        "additionalProperties": false
      },
      "createBiTemporalRelationshipRequest": {
        "type": "object",
        "description": "Request body for POST /v1/catalogues/{catalogue-ref}/relationships.\nIdentifier fields use typed-prefix support identities. logical_relationship_id\nis optional; the server generates a car_ logical relationship identity when absent.\n",
        "required": [
          "relationship_type_entity_id",
          "source_catalogue_entity_id",
          "source_logical_entry_id",
          "source_code",
          "target_catalogue_entity_id",
          "target_logical_entry_id",
          "target_code",
          "valid_from"
        ],
        "properties": {
          "logical_relationship_id": {
            "type": "string",
            "description": "Optional car_ client-supplied logical relationship identity; server generates it when absent.",
            "example": "car_01j1234567890abcdefghijkl",
            "x-axiom-identifier-classification": "opaque-resource-id",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          },
          "relationship_type_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the catalogue relationship-type record.",
            "example": "crp_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "source_catalogue_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the source catalogue.",
            "example": "cat_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "source_logical_entry_id": {
            "type": "string",
            "description": "Typed-prefix cei_ logical source bi-temporal entry identity.",
            "example": "cei_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "source_code": {
            "type": "string",
            "description": "Code of the source entry at the time of relationship creation.",
            "example": "N000123"
          },
          "target_catalogue_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the target catalogue.",
            "example": "cat_01j9876543210abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "target_logical_entry_id": {
            "type": "string",
            "description": "Typed-prefix cei_ logical target bi-temporal entry identity.",
            "example": "cei_01j1234567890abcdefghijkl",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "target_code": {
            "type": "string",
            "description": "Code of the target entry at the time of relationship creation.",
            "example": "ATC-J01CA04"
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Optional JSONB attributes for this relationship.",
            "example": {
              "strength": "500mg",
              "form": "tablet"
            }
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of real-world validity window for this relationship.",
            "example": "2024-01-01T00:00:00Z"
          },
          "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of validity (open-ended if omitted).",
            "example": "2025-01-01T00:00:00Z"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Optional advanced override \u2014 link this row to an existing\nsource-provenance record (e.g. a bulk-load run). When omitted, the\nserver auto-creates a `direct`-kind source-provenance row derived\nfrom the authenticated actor, request time, and X-Correlation-ID;\nthe entry/TV/relationship always traces to a provenance row. A\nsupplied id that does not resolve under the operating tenant\nreturns 404.\n",
            "example": "spv_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "source-provenance-reference",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          }
        },
        "additionalProperties": false
      },
      "createBiTemporalTVRequest": {
        "type": "object",
        "description": "Request body for POST /v1/catalogues/{catalogue-ref}/temporal-values.\nIdentifier fields remain alpha-exception logical references on this\nrequest until the catalogue logical-entry wire contract is migrated.\n",
        "required": [
          "logical_entry_id",
          "code",
          "value_type",
          "value",
          "valid_from"
        ],
        "properties": {
          "logical_entry_id": {
            "type": "string",
            "description": "Logical bi-temporal entry reference this temporal value belongs to.",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "catalogue-logical-entry-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "code": {
            "type": "string",
            "description": "Short code for this temporal value (e.g. \"sep_price\", \"nappi_price\").",
            "example": "sep_price",
            "x-axiom-coded-value-classification": "tenant-catalogue-code"
          },
          "value_type": {
            "type": "string",
            "description": "Discriminator for the value JSONB shape (e.g. \"money\", \"text\", \"boolean\").",
            "example": "money",
            "x-axiom-coded-value-classification": "tenant-catalogue-value-type"
          },
          "value": {
            "type": "object",
            "additionalProperties": true,
            "description": "JSONB payload; shape governed by value_type discriminator.",
            "example": {
              "amount": "267.00",
              "currency_code": "zar"
            }
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 start of real-world validity window.",
            "example": "2024-01-01T00:00:00Z"
          },
          "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 end of validity (open-ended if omitted).",
            "example": "2025-01-01T00:00:00Z"
          },
          "asserted_from": {
            "type": "string",
            "format": "date-time",
            "description": "Optional caller-owned start of the belief (assertion) window (RFC 3339,\nexplicit timezone). The belief axis is settable under the governed contract \u2014 supply it\nto import a historical belief window on tenant take-on, or to record an\nas-was correction. Omitted \u2192 the server defaults asserted_from to now().\n",
            "example": "2024-01-01T00:00:00Z"
          },
          "asserted_to": {
            "type": "string",
            "format": "date-time",
            "description": "Optional end of the belief (assertion) window (RFC 3339, explicit\ntimezone). Omitted \u2192 open belief window (the current belief). When\nsupplied it must be strictly after `asserted_from`, and `asserted_from`\nmust also be supplied.\n",
            "example": "2024-03-01T00:00:00Z"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Optional advanced override \u2014 link this row to an existing\nsource-provenance record (e.g. a bulk-load run). When omitted, the\nserver auto-creates a `direct`-kind source-provenance row derived\nfrom the authenticated actor, request time, and X-Correlation-ID;\nthe entry/TV/relationship always traces to a provenance row. A\nsupplied id that does not resolve under the operating tenant\nreturns 404.\n",
            "example": "spv_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "source-provenance-reference",
            "x-axiom-identifier-shape": "alpha-exception",
            "x-axiom-identifier-alpha-exception": "API 0.2.126 preserves this identifier as a named alpha/operational exception until the owning runtime contract migrates to a canonical typed-prefix or UUID wire shape."
          }
        },
        "additionalProperties": false
      },
      "createCatalogueRequest": {
        "type": "object",
        "required": [
          "slug",
          "name",
          "source",
          "refresh_frequency"
        ],
        "properties": {
          "slug": {
            "type": "string",
            "description": "Unique slug identifier within the tenant (used as the URL path segment)."
          },
          "name": {
            "type": "string",
            "description": "Human-readable display name."
          },
          "source": {
            "type": "string",
            "description": "Upstream data authority."
          },
          "refresh_frequency": {
            "type": "string",
            "description": "Declared refresh cadence (e.g. `annual`, `monthly`, `quarterly`)."
          }
        },
        "additionalProperties": false
      },
      "descriptorDTO": {
        "type": "object",
        "description": "Representation of a catalogue descriptor record.\nReturned by GET and PUT /v1/catalogues/{catalogue-ref}/descriptor.\nid and descriptor_entity_id use the `cde_` typed-prefix wire form;\ntenant context uses `tnt_`; catalogue_entity_id uses `cat_`.\n",
        "required": [
          "id",
          "descriptor_entity_id",
          "catalogue_entity_id",
          "field_inventory",
          "roles",
          "schema_version"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Typed-prefix ID of the descriptor row.",
            "example": "cde_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "descriptor_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the logical descriptor entity.",
            "example": "cde_01j9876543210abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "catalogue_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the parent catalogue entity.",
            "example": "cat_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "catalogue_type": {
            "type": "string",
            "description": "Optional catalogue-type discriminator.",
            "example": "nappi"
          },
          "field_inventory": {
            "type": "object",
            "additionalProperties": true,
            "description": "Freeform JSON object describing the field shape of catalogue entries.",
            "example": {
              "nappi_code": "string",
              "pack_size": "integer"
            }
          },
          "roles": {
            "type": "object",
            "additionalProperties": true,
            "description": "Freeform JSON object mapping role names to their semantics.",
            "example": {
              "primary_code": "nappi_code"
            }
          },
          "schema_version": {
            "type": "integer",
            "description": "Schema version of this descriptor record.",
            "example": 1
          },
          "meta": {
            "$ref": "#/components/schemas/WorkbenchEditReceiptMeta"
          }
        },
        "additionalProperties": false
      },
      "discardCatalogueRequest": {
        "type": "object",
        "required": [
          "reason"
        ],
        "properties": {
          "reason": {
            "type": "string",
            "description": "Non-blank human-intelligible justification for the discard (audit trail)."
          }
        },
        "additionalProperties": false
      },
      "eventReportDTO": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "event_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "pattern": "^evt_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "event-id",
            "x-axiom-identifier-shape": "typed-prefix",
            "example": "evt_01abcdefghjkmnpqrstvwxyz01",
            "description": "Server-assigned identity of the reported event, in canonical typed-prefix\nform. Use this value for every follow-up call that references the event.\n"
          },
          "event": {
            "$ref": "#/components/schemas/Event"
          },
          "documents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ingestAndLinkResultDTO"
            }
          },
          "document_errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "message": {
            "type": "string"
          }
        }
      },
      "ingestAndLinkResultDTO": {
        "type": "object",
        "description": "Result of ingesting one file and linking it to an event/assertion.",
        "additionalProperties": true,
        "properties": {
          "archive_object_id": {
            "type": "string",
            "x-axiom-identifier-classification": "archive-object-id",
            "x-axiom-identifier-shape": "opaque-string",
            "description": "Archive object identifier for the ingested file."
          },
          "original_filename": {
            "type": "string"
          },
          "mime_type": {
            "type": "string"
          }
        }
      },
      "jobStatusDTO": {
        "type": "object",
        "description": "Async job status.\nThis DTO intentionally has no workflow_execution_id field; workflow\nexecution tracking requires a separately admitted contract.\n",
        "required": [
          "id",
          "kind",
          "state",
          "submitted_at",
          "attempt",
          "max_attempts"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^job_[0-9a-hjkmnp-tv-z]{26}$",
            "description": "Typed work-item job identifier.",
            "example": "job_00000000000000000000000456",
            "format": "typed-prefix-id",
            "x-axiom-identifier-classification": "work-item-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "kind": {
            "type": "string",
            "description": "Work type (e.g. `catalogue.ingest`)."
          },
          "state": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "succeeded",
              "failed",
              "dead_letter"
            ],
            "description": "Current job state."
          },
          "submitted_at": {
            "type": "string",
            "format": "date-time",
            "description": "Submission timestamp (RFC 3339)."
          },
          "claimed_at": {
            "type": "string",
            "format": "date-time",
            "description": "When a worker claimed the job (RFC 3339). Omitted until claimed."
          },
          "completed_at": {
            "type": "string",
            "format": "date-time",
            "description": "Terminal-state timestamp (RFC 3339). Omitted until terminal."
          },
          "attempt": {
            "type": "integer",
            "description": "Current attempt number."
          },
          "max_attempts": {
            "type": "integer",
            "description": "Maximum attempts before dead-lettering."
          },
          "correlation_id": {
            "type": "string",
            "description": "Correlation id threaded through the job. Omitted when unset.",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "last_error": {
            "$ref": "#/components/schemas/jobStatusError"
          },
          "error": {
            "$ref": "#/components/schemas/jobStatusError"
          },
          "progress": {
            "$ref": "#/components/schemas/jobStatusProgress"
          }
        },
        "additionalProperties": false
      },
      "jobStatusError": {
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "properties": {
          "code": {
            "type": "string",
            "description": "Machine-readable error code.",
            "x-axiom-coded-value-classification": "platform-error-code"
          },
          "message": {
            "type": "string",
            "description": "Human-readable error message."
          }
        },
        "additionalProperties": false
      },
      "jobStatusProgress": {
        "type": "object",
        "required": [
          "completed_units"
        ],
        "properties": {
          "completed_units": {
            "type": "integer",
            "format": "int64",
            "description": "Units of work completed so far."
          },
          "total_units": {
            "type": "integer",
            "format": "int64",
            "description": "Total units of work, when known. Omitted when indeterminate."
          },
          "message": {
            "type": "string",
            "description": "Free-text progress message."
          },
          "last_updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of the last progress update (RFC 3339)."
          }
        },
        "additionalProperties": false
      },
      "jobStatusResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/jobStatusDTO"
          }
        },
        "additionalProperties": false
      },
      "objectUploadInitiateDTO": {
        "type": "object",
        "description": "Presigned-upload coordinates.\n",
        "required": [
          "upload_id",
          "put_url",
          "object_uri",
          "expires_at"
        ],
        "properties": {
          "upload_id": {
            "type": "string",
            "x-axiom-identifier-classification": "presigned-upload-id",
            "x-axiom-identifier-shape": "opaque-string",
            "description": "Server-assigned upload identifier, referenced in downstream ingest calls.",
            "example": "ref_20260408_0001"
          },
          "put_url": {
            "type": "string",
            "description": "Presigned PUT URL \u2014 upload the raw bytes here with HTTP PUT."
          },
          "object_uri": {
            "type": "string",
            "description": "Canonical storage URI (managed-object://redacted context/upload_id)."
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "description": "Expiry of the presigned URL (RFC 3339); typically 1 hour from issue."
          }
        },
        "additionalProperties": false
      },
      "objectUploadInitiateResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/objectUploadInitiateDTO"
          }
        },
        "additionalProperties": false
      },
      "replacementActor": {
        "type": "object",
        "required": [
          "actor_type",
          "actor_id",
          "actor_original_id"
        ],
        "properties": {
          "actor_type": {
            "type": "string",
            "description": "Actor type (e.g. `human`, `service`)."
          },
          "actor_id": {
            "type": "string",
            "description": "Actor identifier (typed-prefix wire form).",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "description": "Original (pre-merge) actor identifier for audit continuity.",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          }
        },
        "additionalProperties": false
      },
      "replacementAdvanceRequest": {
        "type": "object",
        "required": [
          "actor",
          "reason",
          "occurred_at",
          "evidence_payload",
          "version"
        ],
        "properties": {
          "actor": {
            "$ref": "#/components/schemas/replacementActor"
          },
          "reason": {
            "type": "string",
            "description": "Human-intelligible justification for the advance."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "description": "Business-event timestamp (RFC 3339)."
          },
          "evidence_payload": {
            "type": "object",
            "additionalProperties": true,
            "description": "Step-specific evidence required to advance."
          },
          "version": {
            "type": "integer",
            "description": "Optimistic-concurrency version of the workflow being advanced."
          }
        },
        "additionalProperties": false
      },
      "replacementCancelRequest": {
        "type": "object",
        "required": [
          "actor",
          "reason",
          "occurred_at",
          "version"
        ],
        "properties": {
          "actor": {
            "$ref": "#/components/schemas/replacementActor"
          },
          "reason": {
            "type": "string",
            "description": "Human-intelligible cancellation justification."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "description": "Business-event timestamp (RFC 3339)."
          },
          "version": {
            "type": "integer",
            "description": "Optimistic-concurrency version of the workflow being cancelled."
          }
        },
        "additionalProperties": false
      },
      "replacementDTO": {
        "type": "object",
        "description": "Replacement workflow state.\n",
        "required": [
          "id",
          "policy_id",
          "existing_policy_ids",
          "jurisdiction_code",
          "state",
          "allowed_transitions",
          "version",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Replacement workflow id (prp_ typed-prefix).",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "policy_id": {
            "type": "string",
            "description": "Replacement policy id.",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "existing_policy_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Superseded policy ids."
          },
          "jurisdiction_code": {
            "type": "string",
            "description": "Jurisdiction code (lowercase ISO 3166-1 alpha-2)."
          },
          "state": {
            "type": "string",
            "description": "Current workflow step/state.",
            "x-axiom-coded-value-classification": "tenant-lifecycle-state"
          },
          "config_pack_version_id": {
            "type": "string",
            "description": "Config-pack version governing this workflow's rules.",
            "x-axiom-identifier-classification": "replacement-config-pack-version-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "step_evidence": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Per-step evidence reference ids."
          },
          "step_timestamps": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "format": "date-time"
            },
            "description": "Per-step transition timestamps."
          },
          "transition_history": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            },
            "description": "Ordered transition records."
          },
          "allowed_transitions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Transitions permitted from the current state."
          },
          "explanation_tree_id": {
            "type": "string",
            "description": "Explanation-tree id for this decision (governed contract). Omitted when unset.",
            "x-axiom-identifier-classification": "replacement-explanation-tree-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "version": {
            "type": "integer",
            "description": "Optimistic-concurrency version."
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "time_gate_info": {
            "type": "object",
            "description": "Present when the next step is time-gated.",
            "properties": {
              "step_name": {
                "type": "string"
              },
              "min_wait_duration": {
                "type": "string"
              },
              "earliest_advance": {
                "type": "string",
                "format": "date-time"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "replacementEvidenceDTO": {
        "type": "object",
        "required": [
          "replacement_id",
          "step_evidence",
          "evidence_order"
        ],
        "properties": {
          "replacement_id": {
            "type": "string",
            "format": "typed-prefix-id",
            "description": "Replacement workflow typed-prefix identifier.",
            "example": "prp_01arz3ndektsv4rrffq69g5fav",
            "pattern": "^prp_[0-9a-hjkmnp-tv-z]{26}$",
            "x-axiom-identifier-classification": "policy-replacement-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "step_evidence": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Per-step evidence reference ids."
          },
          "evidence_order": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Ordered list of step names in evidence-collection order."
          }
        },
        "additionalProperties": false
      },
      "replacementEvidenceResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/replacementEvidenceDTO"
          }
        },
        "additionalProperties": false
      },
      "replacementInitiateRequest": {
        "type": "object",
        "required": [
          "policy_id",
          "existing_policy_ids",
          "jurisdiction_code",
          "actor",
          "reason",
          "occurred_at"
        ],
        "properties": {
          "policy_id": {
            "type": "string",
            "description": "The replacement policy id (typed-prefix wire form).",
            "format": "typed-prefix-id",
            "pattern": "^pol_[0-9a-hjkmnp-tv-z]{26}$",
            "example": "pol_01arz3ndektsv4rrffq69g5fav",
            "x-axiom-identifier-classification": "policy-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "existing_policy_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Policies being superseded by this replacement."
          },
          "jurisdiction_code": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 jurisdiction code (lowercase)."
          },
          "actor": {
            "$ref": "#/components/schemas/replacementActor"
          },
          "reason": {
            "type": "string",
            "description": "Human-intelligible justification (audit trail)."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "description": "Business-event timestamp (RFC 3339)."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true,
            "description": "Optional caller-supplied metadata."
          }
        },
        "additionalProperties": false
      },
      "replacementSingleResponse": {
        "type": "object",
        "required": [
          "data"
        ],
        "properties": {
          "data": {
            "$ref": "#/components/schemas/replacementDTO"
          }
        },
        "additionalProperties": false
      },
      "sourceProvenanceDTO": {
        "type": "object",
        "description": "Representation of a source-provenance record for a catalogue bulk-write job.\nReturned as {\"data\": sourceProvenanceDTO} by\nGET /v1/catalogues/{catalogue-ref}/sources/{source_id}.\nruntime source getSourceProvenanceHandler.\nid and source_provenance_entity_id use the `spv_` typed-prefix wire\nform; tenant context uses `tnt_`; catalogue_entity_id uses `cat_`.\n",
        "required": [
          "id",
          "source_provenance_entity_id",
          "catalogue_entity_id",
          "provenance_kind",
          "source_kind",
          "row_count",
          "rows_ok",
          "rows_failed",
          "failure_summary",
          "ingested_at",
          "actor_type",
          "actor_id",
          "actor_original_id",
          "correlation_id",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Typed-prefix ID of this source-provenance row.",
            "example": "spv_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "provenance_kind": {
            "type": "string",
            "enum": [
              "source",
              "retro-attribution",
              "direct"
            ],
            "description": "Discriminator for how this provenance row was created. `source` =\nauthoritative source-file ingest (bulk path). `direct` =\nauthoritative direct API write (no source file; auto-stamped by the\nper-entry write handlers). `retro-attribution` = reconstruction-class\nmetadata (migration-time only). The source-file fields\n(`source_url` / `source_sha256` / `source_file_size_bytes` /\n`source_blob_uri` / `source_blob_content_type`) are present only for\n`source` rows; they are omitted for `direct` rows.\n",
            "example": "direct"
          },
          "source_provenance_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the logical source-provenance entity.",
            "example": "spv_01j9876543210abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "catalogue_entity_id": {
            "type": "string",
            "description": "Typed-prefix ID of the parent catalogue entity.",
            "example": "cat_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          },
          "source_kind": {
            "type": "string",
            "description": "Discriminator for the data source type (e.g. \"nappi_monthly\", \"sep_quarterly\").",
            "example": "nappi_monthly"
          },
          "source_url": {
            "type": "string",
            "description": "Canonical URL of the upstream data file.",
            "example": "https://data.sa-doh.gov.za/nappi/2024-03.csv"
          },
          "source_publication_date": {
            "type": "string",
            "format": "date",
            "description": "Optional date (YYYY-MM-DD) when the upstream source was published.",
            "example": "2024-03-31"
          },
          "source_last_modified": {
            "type": "string",
            "format": "date-time",
            "description": "Optional RFC3339Nano last-modified timestamp from the upstream source.",
            "example": "2024-03-31T12:00:00.000000000Z"
          },
          "source_sha256": {
            "type": "string",
            "description": "SHA-256 hex digest of the raw source file.",
            "example": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
          },
          "source_file_size_bytes": {
            "type": "integer",
            "format": "int64",
            "description": "Size of the raw source file in bytes.",
            "example": 104857600
          },
          "source_blob_uri": {
            "type": "string",
            "description": "Internal blob-storage URI where the ingested file is archived.",
            "example": "managed-object://redacted"
          },
          "source_blob_content_type": {
            "type": "string",
            "description": "MIME type of the archived blob.",
            "example": "text/csv"
          },
          "row_count": {
            "type": "integer",
            "description": "Total number of data rows in the source file.",
            "example": 150000
          },
          "rows_ok": {
            "type": "integer",
            "description": "Number of rows successfully ingested.",
            "example": 149950
          },
          "rows_failed": {
            "type": "integer",
            "description": "Number of rows that failed ingestion.",
            "example": 50
          },
          "failure_summary": {
            "type": "object",
            "additionalProperties": true,
            "description": "Map of failure-reason codes to counts; always present (empty object when rows_failed=0).",
            "example": {
              "INVALID_NAPPI_CODE": 30,
              "MISSING_REQUIRED_FIELD": 20
            }
          },
          "notes": {
            "type": "string",
            "description": "Optional notes. about this ingestion run.",
            "example": "March 2024 NAPPI update \u2014 excludes discontinued products"
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339Nano timestamp when the ingestion job completed.",
            "example": "2024-04-01T06:00:00.000000000Z"
          },
          "actor_type": {
            "type": "string",
            "description": "Type of actor that triggered the ingestion (e.g. \"service_account\", \"human\").",
            "example": "service_account"
          },
          "actor_id": {
            "type": "string",
            "description": "Actor identifier.",
            "example": "ref_20260408_0001",
            "x-axiom-identifier-classification": "actor-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "actor_original_id": {
            "type": "string",
            "description": "Original actor identifier before UUID normalisation (e.g. the Keycloak `sub` subject identifier).",
            "example": "svc-nappi-loader@axiom",
            "x-axiom-identifier-classification": "actor-original-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "correlation_id": {
            "type": "string",
            "description": "Opaque correlation ID linking this ingestion to its originating request.",
            "example": "req-abc-123-def-456",
            "x-axiom-identifier-classification": "correlation-id",
            "x-axiom-identifier-shape": "opaque-string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339Nano creation timestamp of this source-provenance record.",
            "example": "2024-04-01T06:00:00.000000000Z"
          }
        },
        "additionalProperties": false
      },
      "stampLabelRequest": {
        "type": "object",
        "description": "Request body for POST /v1/catalogues/{catalogue-ref}/labels.\nStamps a named snapshot label at a given as_of_date on the catalogue.\n",
        "required": [
          "label_name",
          "as_of_date"
        ],
        "properties": {
          "label_name": {
            "type": "string",
            "description": "Human-readable snapshot name (e.g. \"2024-contract rule-release\").",
            "example": "2024-contract rule-release"
          },
          "as_of_date": {
            "type": "string",
            "format": "date-time",
            "description": "RFC3339 point-in-time the label snapshot is anchored to.",
            "example": "2024-03-31T00:00:00Z"
          },
          "description": {
            "type": "string",
            "description": "Optional free-text description of the label.",
            "example": "contract rule 2024 formulary snapshot"
          }
        },
        "additionalProperties": false
      },
      "supersedeBiTemporalEntryRequest": {
        "type": "object",
        "description": "Request body for POST /v1/catalogues/{catalogue-ref}/entries/{logical_entry_id}/supersede.\nCloses the open-ended bi-temporal entry for the given `logical_entry_id` and\ninserts a successor in one transaction. Only the fields provided are overridden\non the successor row; unset fields are inherited from the prior open version.\n",
        "required": [
          "new_valid_from"
        ],
        "properties": {
          "new_valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Start of the successor version's validity window (RFC 3339). Must be\nstrictly after the prior open version's `valid_from`.\n",
            "example": "2027-01-01T00:00:00Z"
          },
          "new_description": {
            "type": "string",
            "description": "Optional updated human-readable description for the successor version.",
            "example": "Pneumonia, unspecified organism (revised)"
          },
          "new_status": {
            "type": "string",
            "description": "Optional updated lifecycle status for the successor version.",
            "example": "active"
          },
          "new_attributes": {
            "type": "object",
            "additionalProperties": true,
            "description": "Optional replacement JSONB attributes for the successor version. The entire\nattributes map is replaced \u2014 this is not a merge/patch.\n"
          },
          "source_provenance_id": {
            "type": "string",
            "description": "Optional typed-prefix `spv_` source-provenance record ID for this supersede event.",
            "example": "spv_01j1234567890abcdefghijk",
            "x-axiom-identifier-classification": "typed-prefix-wire-id",
            "x-axiom-identifier-shape": "typed-prefix"
          }
        },
        "additionalProperties": false
      },
      "upsertDescriptorRequest": {
        "type": "object",
        "description": "Request body for PUT /v1/catalogues/{catalogue-ref}/descriptor.\nCreates or replaces the catalogue descriptor (schema shape + role map).\nruntime source putCatalogueDescriptorHandler.\n",
        "properties": {
          "catalogue_type": {
            "type": "string",
            "description": "Optional catalogue-type discriminator (e.g. \"nappi\", \"icd10\").",
            "example": "nappi"
          },
          "field_inventory": {
            "type": "object",
            "additionalProperties": true,
            "description": "Freeform JSON object describing the field shape of catalogue entries.",
            "example": {
              "nappi_code": "string",
              "pack_size": "integer"
            }
          },
          "roles": {
            "type": "object",
            "additionalProperties": true,
            "description": "Freeform JSON object mapping role names to their semantics.",
            "example": {
              "primary_code": "nappi_code",
              "display_name": "product_name"
            }
          },
          "schema_version": {
            "type": "integer",
            "description": "Optional caller-supplied schema version; defaults to 1 when omitted.",
            "example": 1
          }
        },
        "additionalProperties": false
      }
    },
    "responses": {
      "BadRequest": {
        "description": "**400 Bad Request**\n\nThe request was malformed or contained invalid parameters.\n\nCommon causes:\n- Missing required parameter\n- Invalid parameter format\n- Invalid JSON syntax\n- Unsupported content type\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missing_parameter": {
                "summary": "Missing required parameter",
                "value": {
                  "errors": [
                    {
                      "status": "400",
                      "code": "MISSING_PARAMETER",
                      "title": "Bad Request",
                      "detail": "Required parameter 'tenant context' is missing",
                      "source": {
                        "parameter": "tenant context"
                      }
                    }
                  ]
                }
              },
              "invalid_uuid": {
                "summary": "Invalid UUID format",
                "value": {
                  "errors": [
                    {
                      "status": "400",
                      "code": "INVALID_PARAMETER",
                      "title": "Bad Request",
                      "detail": "Parameter 'id' must be a valid UUID",
                      "source": {
                        "parameter": "id"
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "Conflict": {
        "description": "**409 Conflict**\n\nThe request conflicts with the current state of the resource.\n\nCommon causes:\n- Attempting to create a duplicate resource\n- Optimistic locking failure (stale version)\n- Invalid state transition\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "duplicate": {
                "summary": "Duplicate resource",
                "value": {
                  "errors": [
                    {
                      "status": "409",
                      "code": "DUPLICATE_RESOURCE",
                      "title": "Conflict",
                      "detail": "A policy with this number already exists"
                    }
                  ]
                }
              },
              "version_conflict": {
                "summary": "Version conflict",
                "value": {
                  "errors": [
                    {
                      "status": "409",
                      "code": "OPTIMISTIC_LOCK_FAILURE",
                      "title": "Conflict",
                      "detail": "Resource was modified by another request. Please refresh and try again.",
                      "meta": {
                        "current_version": 5,
                        "provided_version": 3
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "Forbidden": {
        "description": "**403 Forbidden**\n\nThe authenticated user does not have permission to perform this action.\n\nCommon causes:\n- Insufficient role permissions\n- Accessing another tenant's resource\n- Resource-level access control denial\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "insufficient_permissions": {
                "summary": "Insufficient permissions",
                "value": {
                  "errors": [
                    {
                      "status": "403",
                      "code": "INSUFFICIENT_PERMISSIONS",
                      "title": "Forbidden",
                      "detail": "You do not have permission to perform this action"
                    }
                  ]
                }
              },
              "tenant_access": {
                "summary": "Tenant access denied",
                "value": {
                  "errors": [
                    {
                      "status": "403",
                      "code": "TENANT_ACCESS_DENIED",
                      "title": "Forbidden",
                      "detail": "You are not authorized to access this tenant's resources"
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "GeneralWorkroomImmutable": {
        "description": "General Workroom cannot be renamed, hidden, left, deleted, or moved.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "IdempotencyConflict": {
        "description": "Idempotency-Key was already used with a different request hash.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "InternalError": {
        "description": "**500 Server Error**\n\nAn unexpected error occurred. The correlation ID can be used\nfor support inquiries.\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "errors": [
                {
                  "status": "500",
                  "code": "SERVER_ERROR",
                  "title": "Server Error",
                  "detail": "An unexpected error occurred. Please try again later.",
                  "meta": {
                    "correlation_id": "req-abc-123-def-456"
                  }
                }
              ]
            }
          }
        }
      },
      "LastOwnerRequired": {
        "description": "Workroom must retain at least one owner.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "NotFound": {
        "description": "**404 Not Found**\n\nThe requested resource was not found.\n\nNote: For security, we return 404 instead of 403 when the user\nis not authorized to know whether the resource exists.\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "resource_not_found": {
                "summary": "Resource not found",
                "value": {
                  "errors": [
                    {
                      "status": "404",
                      "code": "RESOURCE_NOT_FOUND",
                      "title": "Not Found",
                      "detail": "The requested policy was not found"
                    }
                  ]
                }
              },
              "endpoint_not_found": {
                "summary": "Endpoint not found",
                "value": {
                  "errors": [
                    {
                      "status": "404",
                      "code": "ENDPOINT_NOT_FOUND",
                      "title": "Not Found",
                      "detail": "The requested endpoint does not exist"
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "ServiceUnavailable": {
        "description": "**503 Service Unavailable**\n\nThe service is temporarily unavailable. Usually due to\nmaintenance or high load.\n",
        "headers": {
          "Retry-After": {
            "description": "Seconds to wait before retrying",
            "schema": {
              "type": "integer",
              "example": 30
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "errors": [
                {
                  "status": "503",
                  "code": "SERVICE_UNAVAILABLE",
                  "title": "Service Unavailable",
                  "detail": "The service is temporarily unavailable. Please try again later.",
                  "help_url": "https://developers.afr-dev.axiom.express/api/reference/0.2.126/errors/SERVICE_UNAVAILABLE/",
                  "meta": {
                    "retry_after": 30
                  }
                }
              ]
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "**429 Too Many Requests**\n\nRate limit exceeded. Retry after the specified period.\n",
        "headers": {
          "Retry-After": {
            "description": "Seconds to wait before retrying",
            "schema": {
              "type": "integer",
              "example": 60
            }
          },
          "X-RateLimit-Limit": {
            "description": "Request limit per time window",
            "schema": {
              "type": "integer",
              "example": 1000
            }
          },
          "X-RateLimit-Remaining": {
            "description": "Remaining requests in current window",
            "schema": {
              "type": "integer",
              "example": 0
            }
          },
          "X-RateLimit-Reset": {
            "description": "Unix timestamp when the rate limit resets",
            "schema": {
              "type": "integer",
              "example": 1707307200
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "errors": [
                {
                  "status": "429",
                  "code": "RATE_LIMITED",
                  "title": "Too Many Requests",
                  "detail": "Rate limit exceeded. Please retry after 60 seconds.",
                  "help_url": "https://developers.afr-dev.axiom.express/api/reference/0.2.126/errors/RATE_LIMITED/",
                  "meta": {
                    "retry_after": 60
                  }
                }
              ]
            }
          }
        }
      },
      "Unauthorized": {
        "description": "**401 Unauthorized**\n\nAuthentication is required but was not provided or is invalid.\n\nCommon causes:\n- Missing Authorization header\n- Invalid or expired token\n- Malformed credentials\n",
        "headers": {
          "WWW-Authenticate": {
            "description": "Authentication challenge",
            "schema": {
              "type": "string",
              "example": "Bearer realm=\"axiom\", error=\"invalid_token\""
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missing_auth": {
                "summary": "Missing authentication",
                "value": {
                  "errors": [
                    {
                      "status": "401",
                      "code": "AUTHENTICATION_REQUIRED",
                      "title": "Unauthorized",
                      "detail": "Authentication is required to access this resource"
                    }
                  ]
                }
              },
              "expired_token": {
                "summary": "Expired token",
                "value": {
                  "errors": [
                    {
                      "status": "401",
                      "code": "TOKEN_EXPIRED",
                      "title": "Unauthorized",
                      "detail": "The provided authentication token has expired"
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "ValidationError": {
        "description": "**422 Unprocessable Entity**\n\nThe request was well-formed but contained semantic errors.\n\nCommon causes:\n- Field validation failures\n- Business rule violations\n- Invalid state transitions\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "single_field": {
                "summary": "Single field validation",
                "value": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "VALIDATION_ERROR",
                      "title": "Validation Error",
                      "detail": "Field 'email' must be a valid email address",
                      "source": {
                        "pointer": "/data/attributes/email"
                      }
                    }
                  ]
                }
              },
              "multiple_fields": {
                "summary": "Multiple validation errors",
                "value": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "VALIDATION_ERROR",
                      "title": "Validation Error",
                      "detail": "Field 'start_date' is required",
                      "source": {
                        "pointer": "/data/attributes/start_date"
                      }
                    },
                    {
                      "status": "422",
                      "code": "VALIDATION_ERROR",
                      "title": "Validation Error",
                      "detail": "Field 'premium' must be greater than 0",
                      "source": {
                        "pointer": "/data/attributes/premium"
                      }
                    }
                  ]
                }
              },
              "business_rule": {
                "summary": "Business rule violation",
                "value": {
                  "errors": [
                    {
                      "status": "422",
                      "code": "BUSINESS_RULE_VIOLATION",
                      "title": "Validation Error",
                      "detail": "Policy end date must be after start date"
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "WorkroomNotFound": {
        "description": "Workroom not found.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "WorkroomPermissionDenied": {
        "description": "The caller's Workroom role does not allow this action.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "WorkroomVisibilityDenied": {
        "description": "The caller cannot see the Workroom.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      }
    }
  },
  "x-axiom-schema-contract": {
    "schema_version": "axiom.public-schema-contract.v1",
    "posture": "classified-alpha-baseline",
    "component_schema_count": 380,
    "object_shape": {
      "closed_object_count": 316,
      "open_extension_object_count": 188,
      "open_object_gap_count": 0,
      "posture": "closed-or-intentional-open"
    },
    "identifier_shape": {
      "typed_id_reference_count": 140,
      "format_constrained_id_count": 59,
      "classified_id_string_count": 158,
      "untyped_id_string_count": 0,
      "posture": "classified-or-constrained"
    },
    "money_shape": {
      "shared_money_reference_count": 16,
      "classified_money_like_count": 1,
      "inline_money_like_count": 0,
      "posture": "shared-money-or-classified"
    },
    "coded_values": {
      "enum_string_count": 150,
      "classified_code_string_count": 54,
      "unconstrained_code_string_count": 0,
      "posture": "enum-or-classified-catalogue"
    }
  }
}
