{
  "service": "journal",
  "surface": "management",
  "contract": "2026-09-11",
  "doc": "Generated from journal.ManagementOperations. SURFACE.md and HTTP.md govern semantics.",
  "bindings": {
    "http": "HTTP.md"
  },
  "operations": [
    {
      "name": "livez",
      "kind": "operational",
      "doc": "the process is up and can answer; empty checks and never 503",
      "params": [],
      "response": "Health",
      "errors": [
        "invalid"
      ],
      "http": {
        "method": "GET",
        "path": "/livez"
      }
    },
    {
      "name": "health",
      "kind": "operational",
      "doc": "whether the durable store and instance identity are ready",
      "params": [],
      "response": "Health",
      "errors": [
        "invalid"
      ],
      "http": {
        "method": "GET",
        "path": "/healthz"
      }
    },
    {
      "name": "describe",
      "kind": "operational",
      "doc": "the management identity, contract, build, binding, operations, refusals and files",
      "params": [],
      "response": "ManagementDescribe",
      "errors": [
        "invalid"
      ],
      "http": {
        "method": "GET",
        "path": "/describe"
      }
    },
    {
      "name": "describe_file",
      "kind": "operational",
      "doc": "one embedded management contract file, verbatim",
      "params": [
        {
          "name": "file",
          "kind": "string",
          "required": true,
          "repeated": false,
          "doc": "an exact management file name listed by describe"
        }
      ],
      "errors": [
        "invalid",
        "not_found"
      ],
      "http": {
        "method": "GET",
        "path": "/describe/{file...}"
      }
    }
  ]
}