QueryRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vectorpanda-com/json-schema/vectorpanda-com-query-request-schema.json",
  "title": "QueryRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vectorpanda-com-openapi.yml#/components/schemas/QueryRequest",
  "type": "object",
  "required": [
    "collection",
    "vector"
  ],
  "properties": {
    "collection": {
      "type": "string",
      "description": "Collection name"
    },
    "vector": {
      "type": "array",
      "items": {
        "type": "number",
        "format": "float"
      },
      "description": "Query vector (must match collection dimension)"
    },
    "top_k": {
      "type": "integer",
      "default": 1000,
      "description": "Maximum number of results to return"
    },
    "similarity_threshold": {
      "type": "number",
      "format": "float",
      "default": 0.7,
      "description": "Minimum similarity score to include in results"
    },
    "distance_metric": {
      "type": "string",
      "enum": [
        "cosine",
        "euclidean",
        "dot_product"
      ],
      "default": "cosine"
    },
    "include_metadata": {
      "type": "boolean",
      "default": false,
      "description": "Include metadata fields in results"
    },
    "use_index": {
      "type": "string",
      "enum": [
        "pca",
        "none"
      ],
      "description": "Index strategy override (default chosen automatically)"
    },
    "filter": {
      "type": "object",
      "additionalProperties": true,
      "description": "MongoDB-style metadata filter. Only results whose metadata\npasses all conditions are returned. Operators: $eq, $ne,\n$gt, $gte, $lt, $lte, $in, $nin. Logical: $and, $or.\nShorthand: {\"field\": \"value\"} means {\"field\": {\"$eq\": \"value\"}}.\nMultiple top-level keys are implicitly $and.\n"
    }
  }
}