latestOpenAPI 3.1.02026-08-21322323412.1 KB

8de9cb14f744

apps-query

Run App Query Batch

Run several guarded SELECTs against the app's bound entities in one request with bounded, cancellation-aware DuckDB execution.

App-level failures (missing / not ready) return 404 / 409. Per-query failures (bad SQL, DuckDB errors) are isolated into each result's error field with HTTP 200 — one broken widget never blanks the page.

post/api/v1/apps/{app_id}/query/batch

Path parameters

app_idstring uuid required

Request body

embed_host_app_idstring uuid nullable

Set when this app is running as an embedded widget inside another app. Authorization then requires VIEWER on that host plus an active embed binding — see domains/apps/application/embed_access.py.

Response

Successful Response