Dashboard v3

Re-point a v3 dashboard at a different dataset

Swap the data underneath an existing board. The board is its own template: its current canvas carries the field roles, and they are resolved onto the new dataset with the same deterministic machinery the apply path uses — no LLM. Send a mapping (the shape /v3/templates/resolve-mapping returns) to use confirmed pairings, or omit it and the server proposes one.

When the new dataset carries the SAME columns — a refreshed extract, the common case — the board keeps the columns its author chose rather than re-scoring and possibly picking differently.

The swap lands as an ordinary canvas version, so undo, revert and version-restore all cover it with nothing extra. Sources are REPLACED, never added, so a board never ends up reading two datasets. Asynchronous because it re-bakes.

post/dashboards/v3/{dashboard_id}/swap-data

Request

  • Base URL: https://app.mammoth.io/api/v2
  • URL: https://app.mammoth.io/api/v2/dashboards/v3/{dashboard_id}/swap-data
  • 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

Request body

Response

Request fulfilled, document 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 6 revisions of this API.