{
  "openapi": "3.1.0",
  "info": {
    "title": "Techora AI Public Agent Metadata API",
    "version": "1.0.0",
    "description": "Public metadata and discovery endpoints for Techora AI. These endpoints expose static discovery files used by AI agents, search agents, and assistant browsers. No authentication is required.",
    "contact": {
      "name": "Techora AI",
      "email": "hello@techora.ai",
      "url": "https://techora.ai"
    }
  },
  "servers": [
    { "url": "https://techora.ai", "description": "Production" }
  ],
  "paths": {
    "/health.json": {
      "get": {
        "summary": "Service health metadata",
        "description": "Returns basic health and identity metadata for Techora AI.",
        "responses": {
          "200": {
            "description": "Health metadata",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "API catalog (RFC 9727 linkset)",
        "description": "Linkset describing public Techora AI metadata endpoints.",
        "responses": {
          "200": {
            "description": "Linkset JSON",
            "content": {
              "application/linkset+json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "summary": "Agent skills index",
        "description": "Index of Techora AI agent skills with SHA-256 integrity hashes for individual skill files.",
        "responses": {
          "200": {
            "description": "Agent skills index",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "summary": "MCP server card",
        "description": "Model Context Protocol server card describing Techora AI's public agent metadata surface.",
        "responses": {
          "200": {
            "description": "MCP server card",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/auth.md": {
      "get": {
        "summary": "Agent access notes",
        "description": "Plain-text notes explaining agent access and how to request protected access.",
        "responses": {
          "200": {
            "description": "Agent access notes",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    }
  }
}