{
  "bindings": {
    "http": "HTTP.md"
  },
  "contract": "2026-09-11",
  "doc": "Generated from management.Operations; SURFACE.md and HTTP.md are the prose contract.",
  "operations": [
    {
      "name": "inventory",
      "kind": "read",
      "doc": "observe artifact count, logical size, ten recent objects and ten largest objects",
      "params": [],
      "response": "Inventory",
      "errors": [
        "inventory_unavailable"
      ],
      "http": {
        "method": "GET",
        "path": "/v1/inventory"
      }
    },
    {
      "name": "livez",
      "kind": "operational",
      "doc": "the management listener can answer",
      "params": [],
      "response": "Health",
      "errors": [],
      "http": {
        "method": "GET",
        "path": "/livez"
      }
    },
    {
      "name": "healthz",
      "kind": "operational",
      "doc": "the management inventory can be read",
      "params": [],
      "response": "Health",
      "errors": [],
      "http": {
        "method": "GET",
        "path": "/healthz"
      }
    },
    {
      "name": "describe",
      "kind": "operational",
      "doc": "this management surface and its build and files",
      "params": [],
      "response": "Description",
      "errors": [],
      "http": {
        "method": "GET",
        "path": "/describe"
      }
    },
    {
      "name": "describe_file",
      "kind": "operational",
      "doc": "one committed management contract file",
      "params": [
        {
          "name": "file",
          "kind": "string",
          "required": true,
          "doc": "a name listed by describe.files"
        }
      ],
      "response": "file",
      "errors": [
        "not_found"
      ],
      "http": {
        "method": "GET",
        "path": "/describe/{file...}"
      }
    }
  ],
  "refusals": [
    {
      "name": "bad_request",
      "http": 400,
      "meaning": "unexpected query parameters or request body"
    },
    {
      "name": "not_found",
      "http": 404,
      "meaning": "the requested management contract file does not exist"
    },
    {
      "name": "inventory_unavailable",
      "http": 503,
      "meaning": "a complete inventory observation could not be obtained; a management failure, not a content refusal"
    }
  ],
  "service": "bytes",
  "surface": "management",
  "surface_document": "SURFACE.md"
}