QueryRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/datagraph-city/json-schema/datagraph-city-query-request-schema.json",
  "title": "QueryRequest",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/datagraph-city-openapi.json#/components/schemas/QueryRequest",
  "properties": {
    "query": {
      "type": "string",
      "title": "Query"
    },
    "city": {
      "type": "string",
      "title": "City",
      "default": "nyc"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category"
    },
    "limit": {
      "type": "integer",
      "maximum": 100.0,
      "minimum": 1.0,
      "title": "Limit",
      "default": 10
    },
    "cypher_query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cypher Query",
      "description": "Optional: Direct Cypher query for advanced users/LLMs. If provided, bypasses natural language translation."
    },
    "cypher_params": {
      "anyOf": [
        {
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cypher Params",
      "description": "Optional: Parameters for the Cypher query (parameterized queries recommended for security)"
    }
  },
  "type": "object",
  "required": [
    "query"
  ]
}