SearchQuery

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/emile-wine/json-schema/emile-wine-search-query-schema.json",
  "title": "SearchQuery",
  "description": "Input for /knowledge/search.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/emile-wine-rag-api-openapi.yml#/components/schemas/SearchQuery",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "title": "Query"
    },
    "language": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "title": "Language",
      "default": "fr"
    },
    "pillars": {
      "anyOf": [
        {
          "items": {
            "type": "string",
            "enum": [
              "vins",
              "viticulture",
              "cave",
              "sommellerie",
              "accord",
              "appellations"
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pillars"
    },
    "top_k": {
      "type": "integer",
      "maximum": 20.0,
      "minimum": 1.0,
      "title": "Top K",
      "default": 8
    }
  },
  "type": "object",
  "required": [
    "query"
  ]
}