{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/axonflow/json-schema/axonflow-override-summary-schema.json",
  "title": "OverrideSummary",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/axonflow-decisions-overrides-api-openapi.yml#/components/schemas/OverrideSummary",
  "$ref": "#/$defs/OverrideView",
  "$defs": {
    "OverrideView": {
      "type": "object",
      "description": "THE element shape for `policy_overrides`. One shape behind all three\nof this plane's views — list, by-id and create.\n\nIt is NOT member-for-member identical to the agent plane's view of the\nsame table (`PolicyOverride`), and saying so precisely matters: this\nshape adds the deprecated `organization_id` alias and does not carry\n`updated_by` / `updated_at`. What it does carry is everything an\nintegrator was missing — `action_override` and `enabled_override` above\nall.\n\nIssue #3944: these were three different shapes. The list view omitted\n`org_id`, `tool_signature`, `created_by` and — the two that matter —\n`action_override` and `enabled_override`, which are what an override\nDOES; the by-id view omitted the same two and spelled the organisation\nkey `organization_id`; and the create response echoed no\n`override_reason`, the mandatory ADR-044 justification the caller had\njust supplied. Listing overrides through this plane could not tell an\noperator what any of them was.\n\nThe three schema NAMES below are retained and each is now this one\nshape, so a client generated from an earlier revision keeps its type.\n",
      "properties": {
        "id": {
          "type": "string"
        },
        "policy_id": {
          "type": "string",
          "description": "The policy this override applies to.\n\n**Its VALUE differs by view, deliberately, and has since before the\nthree views were collapsed onto one shape.** `GET /api/v1/overrides`\nand `GET /api/v1/overrides/{id}` return the canonical UUID stored on\nthe row. Before v11.0.0 the create ECHOED THE VALUE SENT IN THE\nREQUEST and does not resolve it to a UUID — a caller may create an\noverride by slug or name, and the create response hands back what\nthey sent. A client correlating a created override with a later\nlisting must key on `id`, not on `policy_id`.\n\nOne SHAPE across the views is what issue #3944 asked for and what\nthese three now have; identical values on every member is a\ndifferent property, and this member does not hold it.\n"
        },
        "policy_type": {
          "type": "string",
          "description": "`static` or `dynamic`. Deliberately NOT declared as an `enum`: on a\nRESPONSE property oasdiff reads a newly-declared enum as values being\nADDED to a set clients already switch on, and reports four breaking\nchanges for a constraint that tightens nothing.\n"
        },
        "tenant_id": {
          "type": "string",
          "description": "ABSENT on an org-scoped override — the key is omitted, not sent as\n`null`. A NULL tenant column is what makes a row org-scoped rather\nthan tenant-scoped, and the platform marshals that as an omitted\nmember. An earlier revision of this description said \"null\", which\nno response ever contains and which this schema would reject.\n"
        },
        "org_id": {
          "type": "string",
          "description": "The organisation that owns this override. This is the canonical\nspelling on this surface — it is what the column is called and what\nthe agent plane's view of the same table has always emitted.\n"
        },
        "organization_id": {
          "type": "string",
          "deprecated": true,
          "description": "DEPRECATED alias of `org_id`, always carrying the same value. Read\n`org_id`. Retained rather than removed because this is a published\nendpoint and a shipped client may read it.\n\nUnrelated to the `organization_id` on the POLICY surface, which is\ncurrent and not deprecated; the two share a name and nothing else.\n"
        },
        "action_override": {
          "type": "string",
          "description": "WHAT THE OVERRIDE DOES. Absent from this plane's views before\n#3944, which is why an operator could not tell one override from\nanother. Every row created before v11.0.0 carries `allow`.\n"
        },
        "enabled_override": {
          "type": "boolean",
          "description": "Whether the policy is force-enabled or force-disabled by this\noverride. Absent on a row created before v11.0.0 through\n`POST /api/v1/overrides`, which does not set it.\n"
        },
        "override_reason": {
          "type": "string",
          "description": "The mandatory ADR-044 justification (max 500 chars)."
        },
        "expires_at": {
          "type": "string",
          "format": "date-time"
        },
        "tool_signature": {
          "type": "string",
          "description": "Present when the override is restricted to a single tool."
        },
        "created_by": {
          "type": "string"
        },
        "created_at": {
          "type": "string",
          "format": "date-time"
        },
        "revoked_at": {
          "type": "string",
          "format": "date-time",
          "description": "Present only on revoked overrides"
        },
        "revoked_by": {
          "type": "string",
          "description": "Present only on revoked overrides"
        }
      },
      "required": [
        "id",
        "policy_id",
        "policy_type",
        "org_id",
        "organization_id",
        "override_reason",
        "created_by",
        "created_at"
      ]
    }
  }
}