---
title: "Save a dashboard as a workspace template"
method: POST
path: "/dashboards/v3/templates"
tags: ["Dashboard v3 Surfaces"]
---

# Save a dashboard as a workspace template

`POST /dashboards/v3/templates`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/dashboards/v3/templates`
- 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`

Save an existing v3 dashboard as a reusable, workspace-scoped template (save-your-own). The output must re-resolve its OWN dataset at grade 'great' — the SAME self-fit gate curated entries pass — or the save is rejected with a 422 the FE shows verbatim (a dashboard whose roles cannot round-trip its own data is not a usable template). The saved row is tagged source='user', scoped to the workspace and owned by the caller; it lists/fits/applies through the same code paths as curated entries but is NOT added to the curated cross-workspace read allowlist (it keeps normal workspace ACL). Auth: v3 workspace gate + author/editor of the source dashboard + the dashboard's dataview ACL. Returns the saved template's detail payload (card + self-fit recipe + explore).

## Request body

- SaveTemplateSpec: Save a dashboard as a workspace template
  - `params` SaveTemplateParams, required
    - `dashboard_id` integer, required: The v3 dashboard to save as a template (author/editor access required)
    - `title` string, required
    - `description` string

## Response `200`

Template metadata + self-fit recipe

- TemplateDetailResponse
  - `template` object, required
  - `self_fit` object, required
  - `source_dashboard_id` integer, required
  - `explore` object, nullable

## Other responses

- `201`: Document created, URL follows
- `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/5dfd1c296ded?raw)