{
  "openapi": "3.1.0",

  "info": {
    "title": "NURANO AI Knowledge Engine API",
    "version": "1.0.0-GA",
    "description": "Machine-readable API interface for NURANO Knowledge Graph, Search and Provenance systems."
  },

  "servers": [
    {
      "url": "https://nurano.de/api"
    }
  ],

  "paths": {

    "/health": {

      "get": {

        "summary": "System Health Check",

        "responses": {

          "200": {

            "description": "NURANO system status",

            "content": {

              "application/json": {

                "schema": {

                  "type": "object"

                }

              }

            }

          }

        }

      }

    },


    "/search": {

      "get": {

        "summary": "Search NURANO Knowledge Index",

        "parameters": [

          {

            "name": "q",

            "in": "query",

            "required": true,

            "schema": {

              "type": "string"

            },

            "description": "Search query"

          }

        ],

        "responses": {

          "200": {

            "description": "Search results",

            "content": {

              "application/json": {

                "schema": {

                  "type": "object",

                  "properties": {

                    "query": {

                      "type": "string"

                    },

                    "results": {

                      "type": "array"

                    }

                  }

                }

              }

            }

          }

        }

      }

    },


    "/provenance": {

      "get": {

        "summary": "Retrieve Provenance Registry",

        "responses": {

          "200": {

            "description": "Data lineage and source verification",

            "content": {

              "application/json": {

                "schema": {

                  "type": "object"

                }

              }

            }

          }

        }

      }

    }

  },


  "components": {

    "schemas": {

      "KnowledgeObject": {

        "type": "object",

        "properties": {

          "id": {
            "type": "string"
          },

          "type": {
            "type": "string"
          },

          "name": {
            "type": "string"
          },

          "source_reference": {
            "type": "string"
          },

          "provenance_id": {
            "type": "string"
          }

        }

      }

    }

  },


  "x-nurano": {

    "system": "NURANO AI KNOWLEDGE ENGINE",

    "purpose": [
      "KNOWLEDGE_GRAPH",
      "SEMANTIC_SEARCH",
      "AI_AGENT_CONTEXT",
      "PROVENANCE_VERIFICATION"
    ],

    "governance": "SOURCE_FIRST_ZERO_HALLUCINATION"

  }

}