{"openapi":"3.1.0","info":{"title":"dataserver — THE DataGrid Protocol","version":"0.1.0","description":"TDGP (tdgp/1) reference server. Routes are derived from the live dataset registry."},"paths":{"/.well-known/tdgp":{"get":{"summary":"TDGP discovery document","responses":{"200":{"description":"Protocol tdgp/1 discovery document"}}}},"/datasets":{"get":{"summary":"Dataset catalog","responses":{"200":{"description":"Dataset catalog with field + filter metadata"}}}},"/developers/query":{"post":{"summary":"Query the \"developers\" dataset","description":"Synthetic developer directory (Infinite Table classic demo schema, 50k rows)","tags":["developers"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by firstName","value":{"start":0,"limit":5,"sort":[{"field":"firstName","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by firstName, avg(age) per group","value":{"groupBy":[{"field":"firstName"}],"aggregations":[{"id":"age","field":"age","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/developers/filter-values":{"post":{"summary":"Discover filter values for a \"developers\" field","tags":["developers"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of firstName","value":{"field":"firstName","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/developers-1k/query":{"post":{"summary":"Query the \"developers-1k\" dataset","description":"First 1,000 rows of the developers dataset","tags":["developers-1k"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by firstName","value":{"start":0,"limit":5,"sort":[{"field":"firstName","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by firstName, avg(age) per group","value":{"groupBy":[{"field":"firstName"}],"aggregations":[{"id":"age","field":"age","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/developers-1k/filter-values":{"post":{"summary":"Discover filter values for a \"developers-1k\" field","tags":["developers-1k"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of firstName","value":{"field":"firstName","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/developers-10k/query":{"post":{"summary":"Query the \"developers-10k\" dataset","description":"First 10,000 rows of the developers dataset","tags":["developers-10k"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by firstName","value":{"start":0,"limit":5,"sort":[{"field":"firstName","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by firstName, avg(age) per group","value":{"groupBy":[{"field":"firstName"}],"aggregations":[{"id":"age","field":"age","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/developers-10k/filter-values":{"post":{"summary":"Discover filter values for a \"developers-10k\" field","tags":["developers-10k"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of firstName","value":{"field":"firstName","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/orders/query":{"post":{"summary":"Query the \"orders\" dataset","description":"Synthetic orders with an object-valued currency enumeration","tags":["orders"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by customer","value":{"start":0,"limit":5,"sort":[{"field":"customer","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by customer, avg(quantity) per group","value":{"groupBy":[{"field":"customer"}],"aggregations":[{"id":"quantity","field":"quantity","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/orders/filter-values":{"post":{"summary":"Discover filter values for a \"orders\" field","tags":["orders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of customer","value":{"field":"customer","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/quotes/query":{"post":{"summary":"Query the \"quotes\" dataset","description":"Live quote board — random-walk session ticks streamed over SSE","tags":["quotes"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by symbol","value":{"start":0,"limit":5,"sort":[{"field":"symbol","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by symbol, avg(price) per group","value":{"groupBy":[{"field":"symbol"}],"aggregations":[{"id":"price","field":"price","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/quotes/filter-values":{"post":{"summary":"Discover filter values for a \"quotes\" field","tags":["quotes"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of symbol","value":{"field":"symbol","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/hr/query":{"post":{"summary":"Query the \"hr\" dataset","description":"Synthetic employee roster — departments, levels, salaries, hire dates","tags":["hr"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by firstName","value":{"start":0,"limit":5,"sort":[{"field":"firstName","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by firstName, avg(salary) per group","value":{"groupBy":[{"field":"firstName"}],"aggregations":[{"id":"salary","field":"salary","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/hr/filter-values":{"post":{"summary":"Discover filter values for a \"hr\" field","tags":["hr"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of firstName","value":{"field":"firstName","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/trades/query":{"post":{"summary":"Query the \"trades\" dataset","description":"Synthetic equity trade blotter — desks, traders, notionals, settlement","tags":["trades"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by symbol","value":{"start":0,"limit":5,"sort":[{"field":"symbol","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by symbol, avg(quantity) per group","value":{"groupBy":[{"field":"symbol"}],"aggregations":[{"id":"quantity","field":"quantity","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/trades/filter-values":{"post":{"summary":"Discover filter values for a \"trades\" field","tags":["trades"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of symbol","value":{"field":"symbol","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/inventory/query":{"post":{"summary":"Query the \"inventory\" dataset","description":"Synthetic warehouse stock — string PK (sku), reorder levels, supplier grouping","tags":["inventory"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by sku","value":{"start":0,"limit":5,"sort":[{"field":"sku","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by sku, avg(quantityInStock) per group","value":{"groupBy":[{"field":"sku"}],"aggregations":[{"id":"quantityInStock","field":"quantityInStock","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/inventory/filter-values":{"post":{"summary":"Discover filter values for a \"inventory\" field","tags":["inventory"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of sku","value":{"field":"sku","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/performance/query":{"post":{"summary":"Query the \"performance\" dataset","description":"Wide stress dataset — 40 numeric KPI columns for render/scroll benchmarks","tags":["performance"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by segment","value":{"start":0,"limit":5,"sort":[{"field":"segment","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by segment, avg(grossRevenue) per group","value":{"groupBy":[{"field":"segment"}],"aggregations":[{"id":"grossRevenue","field":"grossRevenue","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/performance/filter-values":{"post":{"summary":"Discover filter values for a \"performance\" field","tags":["performance"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of segment","value":{"field":"segment","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/webframeworks/query":{"post":{"summary":"Query the \"webframeworks\" dataset","description":"Popular JavaScript UI libraries — the classic AdapTable documentation demo (GitHub stats, 25 rows)","tags":["webframeworks"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by name","value":{"start":0,"limit":5,"sort":[{"field":"name","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by name, avg(github_stars) per group","value":{"groupBy":[{"field":"name"}],"aggregations":[{"id":"github_stars","field":"github_stars","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/webframeworks/filter-values":{"post":{"summary":"Discover filter values for a \"webframeworks\" field","tags":["webframeworks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of name","value":{"field":"name","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}},"/northwind-orders/query":{"post":{"summary":"Query the \"northwind-orders\" dataset","description":"The classic Microsoft Northwind orders (vendored snapshot, 830 rows)","tags":["northwind-orders"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"type":"array","items":{"type":"string","minLength":1}},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"sort":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"dir":{"type":"string","enum":["asc","desc"]}},"required":["field","dir"]}},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}},"groupBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"groupKeys":{"type":"array","items":{"type":"string"}},"pivotBy":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1}},"required":["field"]}},"aggregations":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"field":{"type":"string","minLength":1},"fn":{"type":"string","enum":["sum","avg","min","max","count"]}},"required":["id","field","fn"]},{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}]}},"process":{"default":{},"type":"object","properties":{"group":{"type":"string","enum":["server","client"]},"pivot":{"type":"string","enum":["server","client"]},"aggregation":{"type":"string","enum":["server","client"]},"pagination":{"type":"string","enum":["server","client"]}}}},"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"firstRows":{"summary":"First rows","value":{"start":0,"limit":5}},"sortedRows":{"summary":"Rows sorted by customerId","value":{"start":0,"limit":5,"sort":[{"field":"customerId","dir":"asc"}]}},"groupAndAggregate":{"summary":"Group by customerId, avg(employeeId) per group","value":{"groupBy":[{"field":"customerId"}],"aggregations":[{"id":"employeeId","field":"employeeId","fn":"avg"}],"limit":10,"process":{"pagination":"server","group":"server","aggregation":"server"}}}}}}},"responses":{"200":{"description":"TDGP response (flat rows, group nodes, or pivot nodes)"},"400":{"description":"TDGP error envelope"}}}},"/northwind-orders/filter-values":{"post":{"summary":"Discover filter values for a \"northwind-orders\" field","tags":["northwind-orders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"field":{"type":"string","minLength":1},"filter":{"$ref":"#/$defs/__schema0"},"filterAql":{"type":"string","minLength":1},"search":{"type":"string"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"withCounts":{"type":"boolean"},"computedFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"aql":{"type":"string","minLength":1}},"required":["id","aql"]}}},"required":["field"],"$defs":{"__schema0":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","const":"group"},"combinator":{"type":"string","enum":["AND","OR"]},"children":{"type":"array","items":{"$ref":"#/$defs/__schema0"}}},"required":["kind","combinator","children"]},{"type":"object","properties":{"kind":{"type":"string","const":"not"},"child":{"$ref":"#/$defs/__schema0"}},"required":["kind","child"]},{"type":"object","properties":{"kind":{"type":"string","const":"predicate"},"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["EQ","NEQ","GT","GTE","LT","LTE","BETWEEN","IN","CONTAINS","STARTS_WITH","ENDS_WITH","IS_BLANK","IS_NOT_BLANK"]},"args":{"type":"array","items":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]}}},"required":["kind","field","operator"]}]}}},"examples":{"distinctValues":{"summary":"Distinct values of customerId","value":{"field":"customerId","limit":20}}}}}},"responses":{"200":{"description":"Distinct filterable values (paginated)"},"400":{"description":"TDGP error envelope"}}}}}}