latestOpenAPI 3.1.02026-08-21322323412.1 KB

8de9cb14f744

apps-query

Run App Query

Run a guarded SELECT against the app's bound ontology entities.

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

Path parameters

app_idstring uuid required

Request body

sqlstring required
limitinteger nullable
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

columnsstring[] required
rowsobject[] required
total_rowsinteger required
truncatedboolean required