{
  "openapi": "3.1.0",
  "info": {
    "title": "MiloslavHub DOWNLOADS consumer API",
    "version": "0.13.3",
    "description": "Locally implemented contract. Production AUTH/ENT source integration and host activation remain closed. Proposed machine profile is not a working OAuth API."
  },
  "servers": [
    {
      "url": "https://downloads.miloslavhub.cz",
      "description": "Closed runtime hosting; distribution requires verified production integrations and activation"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "operationId": "health",
        "tags": [
          "Downloads"
        ],
        "parameters": [],
        "security": [],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Health"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": []
      }
    },
    "/ready": {
      "get": {
        "operationId": "readiness",
        "tags": [
          "Downloads"
        ],
        "parameters": [],
        "security": [],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Ready"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "description": "Dependency or activation not ready; coarse public state only",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Ready"
                }
              }
            }
          }
        },
        "x-required-scopes": []
      }
    },
    "/v1/products": {
      "get": {
        "operationId": "listProducts",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 2048,
              "pattern": "^c1_[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductPage"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ],
        "description": " Keyset pagination; max 200 candidates, max 100 visible items per page. Empty access-filtered pages may have next_cursor. Cursor expires after 15 minutes and binds principal, collection and limit. Current authorization is always rechecked. Products sort by slug/id ascending, releases by created_at/id descending, history by revision/id ascending; live traversal, not a snapshot."
      }
    },
    "/v1/knowledge": {
      "get": {
        "operationId": "listKnowledgeSnapshots",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "knowledge_base",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[a-z][a-z0-9-]{0,79}$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 2048,
              "pattern": "^c1_[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgePage"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ],
        "description": "Current AGENT export permission required for public/protected snapshots; protected also requires AUTH/ENT. Safe metadata only. Source outage 503, denied/withdrawn rows omitted. knowledge_base is exact and cursor-bound. Keyset pagination; max 200 candidates, max 100 visible items per page. Empty access-filtered pages may have next_cursor. Cursor expires after 15 minutes and binds principal, collection and limit. Current authorization is always rechecked. Products sort by slug/id ascending, releases by created_at/id descending, history by revision/id ascending; live traversal, not a snapshot."
      }
    },
    "/v1/knowledge/{package}": {
      "get": {
        "operationId": "getKnowledgeSnapshot",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "package",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeSnapshot"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ],
        "description": "Safe summary without document IDs/content or grant. Fresh AGENT source and protected AUTH/ENT. Use existing download operations for bytes."
      }
    },
    "/v1/openapi": {
      "get": {
        "operationId": "publicOpenApi",
        "tags": [
          "Downloads"
        ],
        "parameters": [],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OpenApiDocument"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ]
      }
    },
    "/v1/products/{product}": {
      "get": {
        "operationId": "getProduct",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "product",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Product"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ]
      }
    },
    "/v1/products/{product}/releases": {
      "get": {
        "operationId": "listReleases",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "product",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 2048,
              "pattern": "^c1_[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleasePage"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ],
        "description": " Keyset pagination; max 200 candidates, max 100 visible items per page. Empty access-filtered pages may have next_cursor. Cursor expires after 15 minutes and binds principal, collection and limit. Current authorization is always rechecked. Products sort by slug/id ascending, releases by created_at/id descending, history by revision/id ascending; live traversal, not a snapshot."
      }
    },
    "/v1/products/{product}/releases/latest": {
      "get": {
        "operationId": "latestRelease",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "stable",
                "beta",
                "development",
                "legacy"
              ]
            }
          },
          {
            "name": "current_version",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 128
            }
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[a-z][a-z0-9-]{0,79}$"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[a-z][a-z0-9-]{0,79}$"
            }
          },
          {
            "name": "architecture",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[a-z][a-z0-9-]{0,79}$"
            }
          },
          {
            "name": "variant",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[a-z][a-z0-9-]{0,79}$"
            }
          },
          {
            "name": "product",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Latest"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ]
      }
    },
    "/v1/releases/{release}": {
      "get": {
        "operationId": "getRelease",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "release",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Release"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.read (protected human)",
          "downloads.installation (future installation profile)"
        ]
      }
    },
    "/v1/downloads": {
      "post": {
        "operationId": "authorizeDownload",
        "tags": [
          "Downloads"
        ],
        "parameters": [],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "201": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Authorization"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.download (protected human)",
          "downloads.installation (future installation profile)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AuthorizationRequest"
              },
              "example": {
                "package_id": "pkg_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
              }
            }
          }
        },
        "description": "Explicitly public package or current human principal + exact package/channel ENT access. Issues 256-bit single-use session, 300â€“900s TTL; only digest stored. Installation auth remains an external dependency."
      }
    },
    "/v1/packages/{package}/content": {
      "get": {
        "operationId": "redeemDownload",
        "tags": [
          "Downloads"
        ],
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 43,
              "pattern": "^[A-Za-z0-9_-]{43}$"
            }
          },
          {
            "name": "package",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 80,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "security": [
          {},
          {
            "accessToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation; private/no-store by default.",
            "headers": {
              "X-Request-ID": {
                "schema": {
                  "type": "string",
                  "maxLength": 64
                }
              },
              "Cache-Control": {
                "schema": {
                  "const": "no-store"
                }
              }
            },
            "content": {
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/json": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/Problem"
          },
          "401": {
            "$ref": "#/components/responses/Problem"
          },
          "403": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "409": {
            "$ref": "#/components/responses/Problem"
          },
          "413": {
            "$ref": "#/components/responses/Problem"
          },
          "415": {
            "$ref": "#/components/responses/Problem"
          },
          "416": {
            "$ref": "#/components/responses/Problem"
          },
          "422": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/Problem"
          },
          "503": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "x-required-scopes": [
          "downloads.download (protected human)",
          "downloads.installation (future installation profile)"
        ],
        "description": "Current same principal plus fresh ENT for protected content. Single attempt; expired/replayed/wrong package/principal token => 404. Range => 416. no-store, attachment, exact MIME/size. Proxies MUST omit query tokens from access logs."
      }
    }
  },
  "components": {
    "schemas": {
      "Problem": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "type": {
            "type": "string",
            "maxLength": 256,
            "format": "uri"
          },
          "title": {
            "type": "string",
            "maxLength": 200
          },
          "status": {
            "type": "integer",
            "minimum": 400,
            "maximum": 599
          },
          "code": {
            "type": "string",
            "maxLength": 80
          },
          "request_id": {
            "type": "string",
            "maxLength": 64,
            "pattern": "^[A-Za-z0-9_-]{1,64}$"
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "code",
          "request_id"
        ]
      },
      "Health": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "up"
            ]
          }
        },
        "required": [
          "status"
        ]
      },
      "Ready": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "ready",
              "not_ready"
            ]
          }
        },
        "required": [
          "status"
        ]
      },
      "Product": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "slug": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 2000
          },
          "visibility": {
            "type": "string",
            "enum": [
              "public",
              "protected"
            ]
          },
          "docs_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512,
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "support_url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512,
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "type": "string",
            "maxLength": 30,
            "format": "date-time"
          },
          "revision": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "id",
          "slug",
          "name",
          "description",
          "visibility",
          "docs_url",
          "support_url",
          "created_at",
          "revision"
        ]
      },
      "Package": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "artifact_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "kind": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "platform": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "architecture": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "variant": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "visibility": {
            "type": "string",
            "enum": [
              "public",
              "protected"
            ]
          },
          "requirements": {
            "type": "object",
            "maxProperties": 20,
            "additionalProperties": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "constraint": {
                  "type": "string",
                  "maxLength": 120,
                  "minLength": 1
                },
                "description": {
                  "type": "string",
                  "maxLength": 500
                }
              },
              "required": [
                "constraint"
              ]
            }
          },
          "filename": {
            "type": "string",
            "maxLength": 160
          },
          "mime": {
            "type": "string",
            "enum": [
              "application/zip",
              "application/pdf",
              "text/plain",
              "text/markdown",
              "application/json"
            ]
          },
          "size": {
            "type": "integer",
            "minimum": 1
          },
          "sha256": {
            "type": "string",
            "maxLength": 64,
            "pattern": "^[a-f0-9]{64}$"
          },
          "status": {
            "type": "string",
            "enum": [
              "quarantine",
              "approved",
              "revoked"
            ]
          },
          "created_at": {
            "type": "string",
            "maxLength": 30,
            "format": "date-time"
          },
          "signature": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "algorithm": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "key_ref": {
                    "type": "string",
                    "maxLength": 120
                  },
                  "value": {
                    "type": "string",
                    "maxLength": 8192
                  }
                },
                "required": [
                  "algorithm",
                  "key_ref",
                  "value"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "integrity": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "required": {
                "type": "boolean"
              },
              "profile": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "miloslavhub-cert-downloads-1"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "job": {
                "anyOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "issuer": {
                        "const": "cert"
                      },
                      "kind": {
                        "type": "string",
                        "enum": [
                          "download",
                          "kb-export"
                        ]
                      },
                      "resource": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "audience": {
                        "const": "downloads"
                      },
                      "nonce": {
                        "const": ""
                      },
                      "request_id": {
                        "type": "string",
                        "maxLength": 64,
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "sha256": {
                        "type": "string",
                        "maxLength": 64,
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "size": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "expires_at": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "media_type": {
                        "type": "string",
                        "maxLength": 80
                      }
                    },
                    "required": [
                      "issuer",
                      "kind",
                      "resource",
                      "audience",
                      "nonce",
                      "request_id",
                      "sha256",
                      "size",
                      "expires_at",
                      "media_type"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "envelope": {
                "anyOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "payloadType": {
                        "const": "application/vnd.miloslavhub.cert.manifest.v1+json"
                      },
                      "payload": {
                        "type": "string",
                        "maxLength": 16384,
                        "pattern": "^[A-Za-z0-9+/]*={0,2}$"
                      },
                      "signatures": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 1,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "keyid": {
                              "type": "string",
                              "maxLength": 80,
                              "pattern": "^ed25519-[a-f0-9]{64}$"
                            },
                            "sig": {
                              "type": "string",
                              "maxLength": 88,
                              "pattern": "^[A-Za-z0-9+/]{86}==$"
                            }
                          },
                          "required": [
                            "keyid",
                            "sig"
                          ]
                        }
                      }
                    },
                    "required": [
                      "payloadType",
                      "payload",
                      "signatures"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "required",
              "profile",
              "job",
              "envelope"
            ]
          },
          "knowledge": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "producer": {
                    "type": "string",
                    "enum": [
                      "agent"
                    ]
                  },
                  "knowledge_base": {
                    "type": "string",
                    "maxLength": 80,
                    "pattern": "^[a-z][a-z0-9-]{0,79}$"
                  },
                  "snapshot_id": {
                    "type": "string",
                    "maxLength": 80,
                    "pattern": "^[a-z][a-z0-9-]{0,79}$"
                  },
                  "snapshot_version": {
                    "type": "string",
                    "maxLength": 128
                  },
                  "created_at": {
                    "type": "string",
                    "maxLength": 30,
                    "format": "date-time"
                  },
                  "classification": {
                    "type": "string",
                    "enum": [
                      "public",
                      "restricted"
                    ]
                  },
                  "manifest_sha256": {
                    "type": "string",
                    "maxLength": 64,
                    "pattern": "^[a-f0-9]{64}$"
                  },
                  "document_count": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000
                  },
                  "licence": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "attribution": {
                    "type": "string",
                    "maxLength": 1000
                  }
                },
                "required": [
                  "producer",
                  "knowledge_base",
                  "snapshot_id",
                  "snapshot_version",
                  "created_at",
                  "classification",
                  "manifest_sha256",
                  "document_count",
                  "licence",
                  "attribution"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "review_reference": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 120
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "artifact_id",
          "kind",
          "platform",
          "architecture",
          "variant",
          "visibility",
          "requirements",
          "filename",
          "mime",
          "size",
          "sha256",
          "status",
          "created_at",
          "signature",
          "integrity",
          "knowledge"
        ]
      },
      "Release": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "product_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "version": {
            "type": "string",
            "maxLength": 128
          },
          "channel": {
            "type": "string",
            "enum": [
              "stable",
              "beta",
              "development",
              "legacy"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "draft",
              "published",
              "deprecated",
              "revoked"
            ]
          },
          "release_notes": {
            "type": "string",
            "maxLength": 20000
          },
          "requirements": {
            "type": "object",
            "maxProperties": 20,
            "additionalProperties": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "constraint": {
                  "type": "string",
                  "maxLength": 120,
                  "minLength": 1
                },
                "description": {
                  "type": "string",
                  "maxLength": 500
                }
              },
              "required": [
                "constraint"
              ]
            }
          },
          "metadata": {
            "type": "object",
            "maxProperties": 20,
            "additionalProperties": {
              "type": [
                "string",
                "number",
                "boolean",
                "null"
              ]
            }
          },
          "published_at": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 30,
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "type": "string",
            "maxLength": 30,
            "format": "date-time"
          },
          "revision": {
            "type": "integer",
            "minimum": 0
          },
          "packages": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/Package"
            }
          },
          "revocation": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "reason": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "revoked_at": {
                    "type": "string",
                    "maxLength": 30,
                    "format": "date-time"
                  },
                  "security_severity": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "info",
                          "low",
                          "medium",
                          "high",
                          "critical"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "replacement_release_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 40,
                        "pattern": "^[a-z]+_[a-f0-9]{32}$"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "reason",
                  "revoked_at",
                  "security_severity",
                  "replacement_release_id"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "product_id",
          "version",
          "channel",
          "status",
          "release_notes",
          "requirements",
          "metadata",
          "published_at",
          "created_at",
          "revision",
          "packages",
          "revocation"
        ]
      },
      "ProductPage": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/Product"
            }
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "items",
          "limit",
          "next_cursor"
        ]
      },
      "ReleasePage": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/Release"
            }
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "items",
          "limit",
          "next_cursor"
        ]
      },
      "Latest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "latest": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Release"
              },
              {
                "type": "null"
              }
            ]
          },
          "update_available": {
            "type": "boolean"
          },
          "current_status": {
            "type": "string",
            "enum": [
              "unknown",
              "published",
              "deprecated",
              "revoked"
            ]
          },
          "current_revoked": {
            "type": "boolean"
          },
          "replacement_release_id": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 40,
                "pattern": "^[a-z]+_[a-f0-9]{32}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "can_request_download": {
            "type": "boolean"
          }
        },
        "required": [
          "latest",
          "update_available",
          "current_status",
          "current_revoked",
          "replacement_release_id",
          "can_request_download"
        ]
      },
      "AuthorizationRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "package_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          }
        },
        "required": [
          "package_id"
        ]
      },
      "Authorization": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "download_url": {
            "type": "string",
            "maxLength": 1024,
            "format": "uri"
          },
          "expires_at": {
            "type": "string",
            "maxLength": 30,
            "format": "date-time"
          },
          "session_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          }
        },
        "required": [
          "download_url",
          "expires_at",
          "session_id"
        ]
      },
      "KnowledgeSnapshot": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "artifact_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "kind": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "platform": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "architecture": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "variant": {
            "type": "string",
            "maxLength": 80,
            "pattern": "^[a-z][a-z0-9-]{0,79}$"
          },
          "visibility": {
            "type": "string",
            "enum": [
              "public",
              "protected"
            ]
          },
          "requirements": {
            "type": "object",
            "maxProperties": 20,
            "additionalProperties": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "constraint": {
                  "type": "string",
                  "maxLength": 120,
                  "minLength": 1
                },
                "description": {
                  "type": "string",
                  "maxLength": 500
                }
              },
              "required": [
                "constraint"
              ]
            }
          },
          "filename": {
            "type": "string",
            "maxLength": 160
          },
          "mime": {
            "type": "string",
            "enum": [
              "application/zip",
              "application/pdf",
              "text/plain",
              "text/markdown",
              "application/json"
            ]
          },
          "size": {
            "type": "integer",
            "minimum": 1
          },
          "sha256": {
            "type": "string",
            "maxLength": 64,
            "pattern": "^[a-f0-9]{64}$"
          },
          "status": {
            "type": "string",
            "enum": [
              "quarantine",
              "approved",
              "revoked"
            ]
          },
          "created_at": {
            "type": "string",
            "maxLength": 30,
            "format": "date-time"
          },
          "signature": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "algorithm": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "key_ref": {
                    "type": "string",
                    "maxLength": 120
                  },
                  "value": {
                    "type": "string",
                    "maxLength": 8192
                  }
                },
                "required": [
                  "algorithm",
                  "key_ref",
                  "value"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "integrity": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "required": {
                "type": "boolean"
              },
              "profile": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "miloslavhub-cert-downloads-1"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "job": {
                "anyOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "issuer": {
                        "const": "cert"
                      },
                      "kind": {
                        "type": "string",
                        "enum": [
                          "download",
                          "kb-export"
                        ]
                      },
                      "resource": {
                        "type": "string",
                        "maxLength": 256
                      },
                      "audience": {
                        "const": "downloads"
                      },
                      "nonce": {
                        "const": ""
                      },
                      "request_id": {
                        "type": "string",
                        "maxLength": 64,
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "sha256": {
                        "type": "string",
                        "maxLength": 64,
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "size": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "expires_at": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "media_type": {
                        "type": "string",
                        "maxLength": 80
                      }
                    },
                    "required": [
                      "issuer",
                      "kind",
                      "resource",
                      "audience",
                      "nonce",
                      "request_id",
                      "sha256",
                      "size",
                      "expires_at",
                      "media_type"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "envelope": {
                "anyOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                      "payloadType": {
                        "const": "application/vnd.miloslavhub.cert.manifest.v1+json"
                      },
                      "payload": {
                        "type": "string",
                        "maxLength": 16384,
                        "pattern": "^[A-Za-z0-9+/]*={0,2}$"
                      },
                      "signatures": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 1,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "properties": {
                            "keyid": {
                              "type": "string",
                              "maxLength": 80,
                              "pattern": "^ed25519-[a-f0-9]{64}$"
                            },
                            "sig": {
                              "type": "string",
                              "maxLength": 88,
                              "pattern": "^[A-Za-z0-9+/]{86}==$"
                            }
                          },
                          "required": [
                            "keyid",
                            "sig"
                          ]
                        }
                      }
                    },
                    "required": [
                      "payloadType",
                      "payload",
                      "signatures"
                    ]
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "required",
              "profile",
              "job",
              "envelope"
            ]
          },
          "knowledge": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "producer": {
                "type": "string",
                "enum": [
                  "agent"
                ]
              },
              "knowledge_base": {
                "type": "string",
                "maxLength": 80,
                "pattern": "^[a-z][a-z0-9-]{0,79}$"
              },
              "snapshot_id": {
                "type": "string",
                "maxLength": 80,
                "pattern": "^[a-z][a-z0-9-]{0,79}$"
              },
              "snapshot_version": {
                "type": "string",
                "maxLength": 128
              },
              "created_at": {
                "type": "string",
                "maxLength": 30,
                "format": "date-time"
              },
              "classification": {
                "type": "string",
                "enum": [
                  "public",
                  "restricted"
                ]
              },
              "manifest_sha256": {
                "type": "string",
                "maxLength": 64,
                "pattern": "^[a-f0-9]{64}$"
              },
              "document_count": {
                "type": "integer",
                "minimum": 1,
                "maximum": 1000
              },
              "licence": {
                "type": "string",
                "maxLength": 200
              },
              "attribution": {
                "type": "string",
                "maxLength": 1000
              }
            },
            "required": [
              "producer",
              "knowledge_base",
              "snapshot_id",
              "snapshot_version",
              "created_at",
              "classification",
              "manifest_sha256",
              "document_count",
              "licence",
              "attribution"
            ]
          },
          "product_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "release_id": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^[a-z]+_[a-f0-9]{32}$"
          },
          "release_version": {
            "type": "string",
            "maxLength": 128
          },
          "channel": {
            "type": "string",
            "enum": [
              "stable",
              "beta",
              "development",
              "legacy"
            ]
          }
        },
        "required": [
          "id",
          "artifact_id",
          "kind",
          "platform",
          "architecture",
          "variant",
          "visibility",
          "requirements",
          "filename",
          "mime",
          "size",
          "sha256",
          "status",
          "created_at",
          "signature",
          "integrity",
          "knowledge",
          "product_id",
          "release_id",
          "release_version",
          "channel"
        ]
      },
      "KnowledgePage": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "items": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/KnowledgeSnapshot"
            }
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "items",
          "limit",
          "next_cursor"
        ]
      },
      "OpenApiDocument": {
        "type": "object",
        "required": [
          "openapi",
          "info",
          "paths",
          "components"
        ],
        "properties": {
          "openapi": {
            "type": "string",
            "enum": [
              "3.1.0"
            ]
          },
          "info": {
            "type": "object"
          },
          "paths": {
            "type": "object"
          },
          "components": {
            "type": "object"
          }
        },
        "additionalProperties": true
      }
    },
    "responses": {
      "Problem": {
        "description": "RFC 9457 problem; sanitized code and request ID; no-store.",
        "headers": {
          "X-Request-ID": {
            "schema": {
              "type": "string",
              "maxLength": 64
            }
          },
          "Cache-Control": {
            "schema": {
              "const": "no-store"
            }
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "accessToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "AUTH-validated access credential for DOWNLOADS audience, current status/revocation and delegated context; ID token is forbidden. Actual profile is not configured. Admin requires MFA and scoped ENT administer."
      }
    }
  }
}
