{
  "openapi": "3.1.0",
  "info": {
    "title": "Databao Site Information API",
    "version": "1.0.0",
    "description": "Read-only, public product information for agents and integrations. This API exposes product, pricing, and agent-use guidance only; it does not expose customer data, analysis functions, accounts, or private application APIs. It uses URL major versioning; read https://databao.app/api/deprecation-policy.md before assuming a future replacement or sunset date.",
    "contact": {
      "name": "Databao contact",
      "url": "https://databao.app/contact/",
      "email": "sales@jetbrains.com"
    }
  },
  "externalDocs": {
    "description": "Databao Site Information API lifecycle and deprecation policy",
    "url": "https://databao.app/api/deprecation-policy.md"
  },
  "servers": [
    {
      "url": "https://databao.app",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/v1/product.json": {
      "get": {
        "operationId": "getDatabaoProduct",
        "summary": "Get the Databao product overview",
        "description": "Returns the product purpose, audience, capabilities, and operating boundaries.",
        "responses": {
          "200": {
            "description": "Product information",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Product" }
              }
            }
          }
        }
      }
    },
    "/api/v1/pricing.json": {
      "get": {
        "operationId": "getDatabaoPricing",
        "summary": "Get current Databao pricing and availability",
        "description": "Returns the alpha price, availability status, and pricing boundaries.",
        "responses": {
          "200": {
            "description": "Pricing and availability information",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/Pricing" }
              }
            }
          }
        }
      }
    },
    "/api/v1/agent-guide.json": {
      "get": {
        "operationId": "getDatabaoAgentGuide",
        "summary": "Get guidance for agents evaluating Databao",
        "description": "Returns when to use Databao and the supported public resources.",
        "responses": {
          "200": {
            "description": "Agent-use guidance",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AgentGuide" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Product": {
        "type": "object",
        "description": "The complete public Databao product summary.",
        "required": ["name", "description", "audience", "capabilities", "boundaries", "documentation_url"],
        "additionalProperties": false,
        "properties": {
          "name": { "type": "string", "description": "Product name" },
          "description": { "type": "string", "description": "One-sentence product description" },
          "audience": { "type": "array", "description": "People the product is designed for", "items": { "type": "string" } },
          "capabilities": { "type": "array", "description": "Supported product capabilities", "items": { "type": "string" } },
          "boundaries": { "type": "array", "description": "Important product limitations and privacy boundaries", "items": { "type": "string" } },
          "documentation_url": { "type": "string", "format": "uri", "description": "Canonical product documentation URL" }
        }
      },
      "Pricing": {
        "type": "object",
        "description": "The complete public Databao price and availability summary.",
        "required": ["currency", "price", "availability", "notes", "pricing_page_url"],
        "additionalProperties": false,
        "properties": {
          "currency": { "type": "string", "description": "ISO 4217 currency", "example": "USD" },
          "price": { "type": "number", "description": "Current Databao desktop-app price", "example": 0 },
          "availability": { "type": "string", "description": "Current release status", "example": "alpha" },
          "notes": { "type": "array", "description": "Conditions and exclusions", "items": { "type": "string" } },
          "pricing_page_url": { "type": "string", "format": "uri", "description": "Canonical pricing and availability page URL" }
        }
      },
      "AgentGuide": {
        "type": "object",
        "description": "The complete public agent-use guidance for Databao.",
        "required": ["when_to_use", "do_not_use_for", "resources"],
        "additionalProperties": false,
        "properties": {
          "when_to_use": { "type": "array", "description": "Jobs for which Databao is a good fit", "items": { "type": "string" } },
          "do_not_use_for": { "type": "array", "description": "Unsupported assumptions", "items": { "type": "string" } },
          "resources": {
            "type": "object",
            "description": "Stable URLs for additional documentation.",
            "required": ["homepage", "documentation", "pricing", "llms_guidance", "openapi"],
            "additionalProperties": false,
            "properties": {
              "homepage": { "type": "string", "format": "uri", "description": "Databao landing page" },
              "documentation": { "type": "string", "format": "uri", "description": "Product documentation" },
              "pricing": { "type": "string", "format": "uri", "description": "Pricing and availability" },
              "llms_guidance": { "type": "string", "format": "uri", "description": "Agent-readable product guidance" },
              "openapi": { "type": "string", "format": "uri", "description": "Site Information API specification" }
            }
          }
        }
      }
    }
  }
}