/api/agent

POST /api/agent/v1/question/{id}/query

Changed on

Run a saved question (card) and return its results.

Executes the query stored on the card under the caller's permissions and returns rows + column metadata — the same response shape as /v1/execute.

Parameterized questions are NOT supported: if the card declares parameters or input template tags (field filters / variables), this returns a 400. Run it in Metabase, or save a parameterless version.

post/api/agent/v1/question/{id}/query

Request

  • Base URL
    (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    API key in header X-API-Key

Path parameters

idinteger required

value must be an integer greater than zero.

Request body

object required

Response

Successful response

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

Changes