{
  "openapi": "3.1.0",
  "info": {
    "title": "Kineos Public API",
    "version": "1.0.0",
    "description": "Read-only public metadata API for Kineos product and API discovery. This specification does not expose tenant, student, contract, payment, authentication or studio-management operations.",
    "termsOfService": "https://www.kineosapp.com.br/termos-de-uso",
    "contact": {
      "name": "Kineos",
      "url": "https://www.kineosapp.com.br/contato",
      "email": "contato@kineosapp.com.br"
    }
  },
  "servers": [
    {
      "url": "https://www.kineosapp.com.br",
      "description": "Kineos public website"
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "Public metadata",
      "description": "Non-sensitive, read-only information intended for public discovery and automated agents."
    }
  ],
  "paths": {
    "/api/public/v1/status": {
      "get": {
        "operationId": "getKineosPublicApiStatus",
        "summary": "Get public API status",
        "description": "Returns the availability and canonical discovery links for the Kineos public metadata surface. It is not a health check for tenant data, payments or third-party integrations.",
        "tags": ["Public metadata"],
        "responses": {
          "200": {
            "description": "Public API metadata is available.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiStatus"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/v1/capabilities": {
      "get": {
        "operationId": "getKineosPublicCapabilities",
        "summary": "List intentionally public capabilities",
        "description": "Describes the limited capabilities that Kineos intentionally exposes to unauthenticated clients and agents.",
        "tags": ["Public metadata"],
        "responses": {
          "200": {
            "description": "Intentional public capabilities.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicCapabilities"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PublicApiStatus": {
        "type": "object",
        "additionalProperties": false,
        "required": ["product", "api_version", "scope", "status", "documentation", "openapi"],
        "properties": {
          "product": {
            "type": "string",
            "const": "Kineos"
          },
          "api_version": {
            "type": "string",
            "const": "v1"
          },
          "scope": {
            "type": "string",
            "const": "public-metadata"
          },
          "status": {
            "type": "string",
            "const": "available"
          },
          "documentation": {
            "type": "string",
            "format": "uri"
          },
          "openapi": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "PublicCapability": {
        "type": "object",
        "additionalProperties": false,
        "required": ["id", "description"],
        "properties": {
          "id": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "PublicCapabilities": {
        "type": "object",
        "additionalProperties": false,
        "required": ["product", "api_version", "scope", "capabilities", "business_operations_public", "public_methods", "documentation"],
        "properties": {
          "product": {
            "type": "string",
            "const": "Kineos"
          },
          "api_version": {
            "type": "string",
            "const": "v1"
          },
          "scope": {
            "type": "string",
            "const": "public-metadata"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicCapability"
            }
          },
          "business_operations_public": {
            "type": "boolean",
            "const": false
          },
          "public_methods": {
            "type": "array",
            "items": {
              "type": "string",
              "const": "GET"
            }
          },
          "documentation": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    }
  },
  "x-kineos-scope": "public-metadata-only"
}