---
title: "Update Metric Dashboard"
method: PATCH
path: "/v1/metrics/dashboards/{id}"
tags: ["metrics", "public"]
---

# Update Metric Dashboard

`PATCH /v1/metrics/dashboards/{id}`

Update a user-defined metric dashboard.

**Scopes**: `metrics:write`

## Path parameters

- `id` string, uuid4, required — The metric dashboard ID.

## Request body

- MetricDashboardUpdate — Schema for updating a metrics dashboard.
  - `name` string, nullable — Display name for the dashboard.
  - `metrics` string[], nullable — List of metric slugs to display in this dashboard.

## Response `200`

Successful Response

- MetricDashboardSchema — A user-defined metrics dashboard.
  - `created_at` string, date-time, required — Creation timestamp of the object.
  - `modified_at` string, date-time, nullable, required — Last modification timestamp of the object.
  - `id` string, uuid4, required — The ID of the object.
  - `name` string, required — Display name for the dashboard.
  - `metrics` string[], required — List of metric slugs displayed in this dashboard.
  - `organization_id` string, uuid4, required — The ID of the organization owning this dashboard.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/versions/964f974aceff/schema)