v12

latestOpenAPI 3.1.0AGPL-3.0raw.githubusercontent.com2026-05-286377631.6 MB
/api/agent

POST /api/agent/v1/execute

Execute an MBQL query and return results.

Accepts a base64-encoded MBQL query (as returned by /v1/construct-query) and executes it, returning results with column metadata.

Response format:

  • On success: {:data {:cols [...] :rows [...]} :row_count N :status :completed :running_time M}
  • On failure: {:status :failed :error "message" ...}

Standard userspace query limits are enforced (2000 rows for simple queries, 10000 for aggregated).

post/api/agent/v1/execute

Request body

querystring required

Response

Successful response

errorstring
row_countinteger
running_timeinteger
status'completed' | 'failed' required