---
title: "Re-point a v3 dashboard at a different dataset"
method: POST
path: "/dashboards/v3/{dashboard_id}/swap-data"
tags: ["Dashboard v3"]
---

# Re-point a v3 dashboard at a different dataset

`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`

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.

## Path parameters

- `dashboard_id` integer, required

## Request body

- SwapDataSpec: Re-point a dashboard at a different dataset
  - `params` SwapDataParams, required
    - `dataview_id` integer, required
    - `mapping` object, nullable
    - `overrides` object, nullable
    - `currency` string, nullable

## Response `200`

Request fulfilled, document follows

- ObjectJobSchema
  - `status_code` integer, nullable
  - `job_id` integer, nullable: Created job id
  - `failure_reason` string, nullable: Failure reason if status is failure

## Other responses

- `400`: Bad request syntax or unsupported method
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/17af8131167d?raw)