Dashboard v3 Q&A

One Q&A ask turn (async)

Runs one agentic ask turn: the engine emits a constrained query plan, the descriptor executor computes RLS-scoped numbers, and each answer block is baked to SVG. Returns a job_id; poll /jobs/{id} for {answer}. Editors always ask; viewers ask unless allow_viewer_qa was switched off or the dashboard is shared by public link, and are capped per day.

post/dashboards/{dashboard_id}/qa/sessions/{session_id}/ask

Request

  • Base URL: https://app.mammoth.io/api/v2
  • URL: https://app.mammoth.io/api/v2/dashboards/{dashboard_id}/qa/sessions/{session_id}/ask
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-KEY and API key in header X-API-SECRET and API key in header X-WORKSPACE-ID

Path parameters

dashboard_idinteger required
session_idinteger required

Request body

Response

Document created, URL follows

status_codeinteger nullable
job_idinteger nullable

Created job id

failure_reasonstring nullable

Failure reason if status is failure

Changes

No recorded changes to this operation across all 5 revisions of this API.