query_tables

Answer a natural-language question over uploaded table files — one or several.

Cost class: slow.

paths is a list of selection rows — {"path": ...} for a whole file, {"path": ..., "component": <tab>} for one tab of one workbook (repeat the path to select several tabs). Every path must be a table file — a spreadsheet (xlsx, xls, xlsm, xlsb, ods) or record file (csv, tsv, parquet, jsonl, ndjson, json); a document, media, or image path is refused with invalid_request naming qa-file. Every tab is askable whatever its ingestion produced: selections whose tabs all have extracted rows are answered by the SQL engine — the answer keeps full result parquet storage outside the response and returns bounded previews plus authenticated workspace result-file citations — while a selection holding tabs with only a rendered sheet is answered by a QA agent that reads renderings and queries row extractions together (no result previews on that lane; citations quote the sheets).

component names are workbook-local — the same strings file-metadata and filtered-search publish as component, matched exact-name first, then the unambiguous sanitized alias. A name that matches nothing on its own workbook — or any component on a single-table upload (csv/jsonl/parquet), which has no named parts — is invalid_request. A selected tab with no usable content at all is reported in unavailable rather than silently dropped.

Execution survives HTTP disconnects. By default the route waits and returns the original answer shape. Send Prefer: respond-async to return a Job immediately, then poll its Location URL. Idempotency-Key recovers the same job after a lost response. Only explicit job cancellation stops it.