---
title: "Changes to Update an existing dashboard"
method: PUT
path: "/v2/dashboards/{dashboardId}"
---

# Changes to Update an existing dashboard

`PUT /v2/dashboards/{dashboardId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 75 revisions.

- **2026-08-20** `b576ea92fca2` — 1 breaking, 5 warning, 8 info
- **2026-08-08** `f920f418f552` — 7 warning, 7 info
- **2026-08-07** `0261aef4b1e2` — 5 breaking, 2 warning, 1 info
- **2026-07-23** `3b46cb8e839f` — 6 info
- **2026-07-22** `231c616fc23b` — 12 warning, 12 info
- **2026-07-16** `a2e95e9f6c80` — 7 warning, 7 info
- **2026-06-30** `164458859caa` — 1 breaking, 3 info
- **2026-06-08** `c83332d134eb` — 1 breaking, 10 warning, 13 info
- **2026-05-12** `b7554548ae3a` — 1 info

## Changes

- **2026-08-20** `b576ea92fca2` — 1 breaking, 5 warning, 8 info
  - added `#/components/schemas/ManagedCacheUsageQuery` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query` response property `oneOf` list for the response status `200`
  - added the new `data_plane_group` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `managed_cache` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `network` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `provider` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `provider_region` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added `managed_cache_usage` discriminator mapping keys to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query` request property
  - added the new `data_plane_group` enum value to the request property `definition/preset_filters/items/field`
  - added the new `managed_cache` enum value to the request property `definition/preset_filters/items/field`
  - added the new `network` enum value to the request property `definition/preset_filters/items/field`
  - added the new `provider` enum value to the request property `definition/preset_filters/items/field`
  - added the new `provider_region` enum value to the request property `definition/preset_filters/items/field`
  - added `#/components/schemas/ManagedCacheUsageQuery` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query` request property `oneOf` list
  - added `managed_cache_usage` discriminator mapping keys to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query` response property for the response status `200`
- **2026-08-08** `f920f418f552` — 7 warning, 7 info
  - added the new `cache_hit_rate` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/` response property for the response status `200`
  - added the new `cache_hit_rate` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/` response property for the response status `200`
  - added the new `cache_status` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `cache_status` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AdvancedQuery]/dimensions/items/` response property for the response status `200`
  - added the new `cache_status` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AdvancedQuery]/filters/items/field` response property for the response status `200`
  - added the new `cache_status` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AgenticQuery]/dimensions/items/` response property for the response status `200`
  - added the new `cache_status` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AgenticQuery]/filters/items/field` response property for the response status `200`
  - added the new `cache_hit_rate` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/`
  - added the new `cache_hit_rate` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/`
  - added the new `cache_status` enum value to the request property `definition/preset_filters/items/field`
  - added the new `cache_status` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AdvancedQuery]/dimensions/items/`
  - added the new `cache_status` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AdvancedQuery]/filters/items/field`
  - added the new `cache_status` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AgenticQuery]/dimensions/items/`
  - added the new `cache_status` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/oneOf[#/components/schemas/ChartTileDefinition]/query/oneOf[#/components/schemas/AgenticQuery]/filters/items/field`
- **2026-08-07** `0261aef4b1e2` — 5 breaking, 2 warning, 1 info
  - the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition` request property type/format changed from `object`/`` to ``/``
  - added `#/components/schemas/ChartTileDefinition, #/components/schemas/TableChartTileDefinition` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition` response property `oneOf` list for the response status `200`
  - the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/chart` from the response with the `200` status
  - removed the required property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query` from the response with the `200` status
  - removed the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/chart`
  - removed the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query`
  - added `#/components/schemas/ChartTileDefinition, #/components/schemas/TableChartTileDefinition` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition` request property `oneOf` list
- **2026-07-23** `3b46cb8e839f` — 6 info
  - added the new optional request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/limit`
  - added the new optional request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/limit`
  - added the new optional request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/limit`
  - added the optional property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/limit` to the response with the `200` status
  - added the optional property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/limit` to the response with the `200` status
  - added the optional property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/limit` to the response with the `200` status
- **2026-07-22** `231c616fc23b` — 12 warning, 12 info
  - added the new `env` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `env` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/` response property for the response status `200`
  - added the new `env` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field` response property for the response status `200`
  - added the new `hostname` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `hostname` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/` response property for the response status `200`
  - added the new `hostname` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field` response property for the response status `200`
  - added the new `region` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `region` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/` response property for the response status `200`
  - added the new `region` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field` response property for the response status `200`
  - added the new `team` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `team` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/` response property for the response status `200`
  - added the new `team` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field` response property for the response status `200`
  - added the new `env` enum value to the request property `definition/preset_filters/items/field`
  - added the new `env` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/`
  - added the new `env` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field`
  - added the new `hostname` enum value to the request property `definition/preset_filters/items/field`
  - added the new `hostname` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/`
  - added the new `hostname` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field`
  - added the new `region` enum value to the request property `definition/preset_filters/items/field`
  - added the new `region` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/`
  - added the new `region` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field`
  - added the new `team` enum value to the request property `definition/preset_filters/items/field`
  - added the new `team` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/dimensions/items/`
  - added the new `team` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/PlatformQuery]/filters/items/field`
- **2026-07-16** `a2e95e9f6c80` — 7 warning, 7 info
  - added the new `principal` enum value to the `definition/preset_filters/items/field` response property for the response status `200`
  - added the new `principal` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/dimensions/items/` response property for the response status `200`
  - added the new `principal` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/filters/items/field` response property for the response status `200`
  - added the new `principal` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/dimensions/items/` response property for the response status `200`
  - added the new `principal` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/filters/items/field` response property for the response status `200`
  - added the new `principal` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/dimensions/items/` response property for the response status `200`
  - added the new `principal` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/filters/items/field` response property for the response status `200`
  - added the new `principal` enum value to the request property `definition/preset_filters/items/field`
  - added the new `principal` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/dimensions/items/`
  - added the new `principal` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/filters/items/field`
  - added the new `principal` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/dimensions/items/`
  - added the new `principal` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/filters/items/field`
  - added the new `principal` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/dimensions/items/`
  - added the new `principal` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/filters/items/field`
- **2026-06-30** `164458859caa` — 1 breaking, 3 info
  - added `#/components/schemas/TopNChart` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/chart` response property `oneOf` list for the response status `200`
  - added `top_n` discriminator mapping keys to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/chart` request property
  - added `#/components/schemas/TopNChart` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/chart` request property `oneOf` list
  - added `top_n` discriminator mapping keys to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/chart` response property for the response status `200`
- **2026-06-08** `c83332d134eb` — 1 breaking, 10 warning, 13 info
  - added `#/components/schemas/PlatformQuery` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query` response property `oneOf` list for the response status `200`
  - added the new `error_rate` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/` response property for the response status `200`
  - added the new `error_rate` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_average` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_average` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_p50` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_p50` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_p95` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_p95` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_p99` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/` response property for the response status `200`
  - added the new `kong_internal_latency_p99` enum value to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/` response property for the response status `200`
  - added `platform_usage` discriminator mapping keys to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query` request property
  - added the new `error_rate` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/`
  - added the new `error_rate` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/LLMQuery]/metrics/items/`
  - added the new `kong_internal_latency_average` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/`
  - added the new `kong_internal_latency_average` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/`
  - added the new `kong_internal_latency_p50` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/`
  - added the new `kong_internal_latency_p50` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/`
  - added the new `kong_internal_latency_p95` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/`
  - added the new `kong_internal_latency_p95` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/`
  - added the new `kong_internal_latency_p99` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AdvancedQuery]/metrics/items/`
  - added the new `kong_internal_latency_p99` enum value to the request property `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query/oneOf[#/components/schemas/AgenticQuery]/metrics/items/`
  - added `#/components/schemas/PlatformQuery` to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query` request property `oneOf` list
  - added `platform_usage` discriminator mapping keys to the `definition/tiles/items/oneOf[#/components/schemas/ChartTile]/definition/query` response property for the response status `200`
- **2026-05-12** `b7554548ae3a` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v2/dashboards/:dashboardId/put.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v2/dashboards/:dashboardId/put)