{
  "openapi": "3.1.0",
  "info": {
    "title": "Stack Insider public surface",
    "version": "1.0.0",
    "description": "Read-only HTTP resources for discovery and machine-friendly content. HTML pages support optional Markdown via the Accept header (see site deployment notes). Most pages also have a `.txt` sibling URL with the same path plus `.txt` for plain text."
  },
  "servers": [{ "url": "https://stack-insider.com" }],
  "paths": {
    "/health": {
      "get": {
        "summary": "Availability check",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Service is reachable",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": { "type": "string", "example": "ok" },
                    "service": { "type": "string", "example": "stack-insider" }
                  }
                }
              }
            }
          }
        }
      },
      "head": {
        "summary": "Availability check (no body)",
        "operationId": "headHealth",
        "responses": { "200": { "description": "OK" } }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "RFC 9727 API catalog (linkset)",
        "operationId": "getApiCatalog",
        "responses": {
          "200": {
            "description": "Linkset describing published APIs and related links",
            "content": {
              "application/linkset+json": {
                "schema": { "type": "object", "additionalProperties": true }
              }
            }
          }
        }
      },
      "head": {
        "summary": "API catalog metadata",
        "operationId": "headApiCatalog",
        "responses": { "200": { "description": "OK" } }
      }
    },
    "/openapi.json": {
      "get": {
        "summary": "This OpenAPI document",
        "operationId": "getOpenApiSpec",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1 JSON",
            "content": {
              "application/vnd.oai.openapi+json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    }
  }
}