---
title: "PUT /api/v1/config/classic-dashboards/{slug}"
method: PUT
path: "/api/v1/config/classic-dashboards/{slug}"
tags: ["ClassicDashboard"]
---

# PUT /api/v1/config/classic-dashboards/{slug}

`PUT /api/v1/config/classic-dashboards/{slug}`

## Path parameters

- `slug` string, required

## Request body

- ConfigV1UpdateClassicDashboardBody
  - `classic_dashboard` Configv1GrafanaDashboard
    - `slug` string — Unique identifier of the GrafanaDashboard. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the GrafanaDashboard is created.
    - `name` string — Required. Name of the GrafanaDashboard. You can modify this value after the GrafanaDashboard is created.
    - `created_at` string, date-time — Timestamp of when the GrafanaDashboard was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the GrafanaDashboard was last updated. Cannot be set by clients.
    - `bucket_slug` string — Slug of the bucket the dashboard belongs to. Required if collection_slug is not set.
    - `collection_slug` string — Slug of the collection the dashboard belongs to. Required if bucket_slug is not set.
    - `collection` Configv1CollectionReference
      - `type` 'SIMPLE' | 'SERVICE' — Type values must match entitiespb.Collection.CollectionType.
      - `slug` string
    - `dashboard_json` string — Required raw JSON of the Grafana dashboard.
  - `create_if_missing` boolean — If true, the GrafanaDashboard will be created if it does not already exist, identified by slug. If false, an error will be returned if the GrafanaDashboard does not already exist.
  - `dry_run` boolean — If true, the GrafanaDashboard isn't created or updated, and no response GrafanaDashboard will be returned. The response will return an error if the given GrafanaDashboard is invalid.

## Response `200`

A successful response containing the updated GrafanaDashboard.

- Configv1UpdateClassicDashboardResponse
  - `classic_dashboard` Configv1GrafanaDashboard
    - `slug` string — Unique identifier of the GrafanaDashboard. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the GrafanaDashboard is created.
    - `name` string — Required. Name of the GrafanaDashboard. You can modify this value after the GrafanaDashboard is created.
    - `created_at` string, date-time — Timestamp of when the GrafanaDashboard was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the GrafanaDashboard was last updated. Cannot be set by clients.
    - `bucket_slug` string — Slug of the bucket the dashboard belongs to. Required if collection_slug is not set.
    - `collection_slug` string — Slug of the collection the dashboard belongs to. Required if bucket_slug is not set.
    - `collection` Configv1CollectionReference
      - `type` 'SIMPLE' | 'SERVICE' — Type values must match entitiespb.Collection.CollectionType.
      - `slug` string
    - `dashboard_json` string — Required raw JSON of the Grafana dashboard.

## Other responses

- `400` — Cannot update the GrafanaDashboard because the request is invalid.
- `404` — Cannot update the GrafanaDashboard because the slug does not exist.
- `409` — Cannot update the GrafanaDashboard because there is a conflict with an existing GrafanaDashboard.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.net/chronosphere/apis/config-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/config-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/config-v1-api/revisions/530951bd2ccf/schema)