The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are AppQueryBatchItemResult (6 properties), ValidationError (5 properties), AppQueryResponse (4 properties), AppQueryBatchItem (3 properties). Each schema is shown below with its type and property counts.
AppQueryResponse
object
4 properties4 required
AppQueryBatchResponse
object
1 property1 required
ValidationError
object
5 properties3 required
AppQueryBatchRequest
object
Body for POST /api/v1/apps/{appid}/query/batch. Runs every query against the app's bound entities on a SINGLE shared DuckDB connection: the source⊕overlay merg…
1 property1 required
HTTPValidationError
object
1 property
AppQueryBatchItemResult
object
Result for one batch query. Exactly one of (data, error) is meaningful: on failure columns/rows are empty and error holds the message.
6 properties5 required
AppQueryBatchItem
object
One query in a batch. id is a caller-supplied correlation key (e.g. the widget id) echoed back on the matching result so the client maps results without relyin…
3 properties2 required
AppQueryRequest
object
Body for POST /api/v1/apps/{appid}/query. Single mode: caller passes optional limit (default 1000, max 5000). Pagination is NOT supported at this endpoint — wr…
2 properties1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
