---
title: "Changes to Replace Widgets on Dashboard"
method: PUT
path: "/console/v1/dashboards/{id}/widgets"
---

# Changes to Replace Widgets on Dashboard

`PUT /console/v1/dashboards/{id}/widgets`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 41 revisions.

- **2026-10-30** `a7f43412fb6b`: 3 breaking, 2 warning, 10 info

## Changes

- **2026-10-30** `a7f43412fb6b`: 3 breaking, 2 warning, 10 info
  - added the new required request property `revision`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `widgets/items/` request property `oneOf` list
  - the `defaults/date` request property type changed from `object` to no type
  - removed the request property `defaults/date/unit`
  - removed the request property `defaults/date/value`
  - added the new optional request property `delete_widget_ids`
  - the request property `defaults` became nullable
  - removed discriminator from `widgets/items/` request property
  - added `#/components/schemas/DashboardShared_schema1, #/components/schemas/DashboardShared_schema12, subschema #3` to the `widgets/items/` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `defaults/date` request property `oneOf` list
  - added the non-success response with the status `400`
  - added the non-success response with the status `409`
  - added the non-success response with the status `412`
  - added the required property `allOf[subschema #2]/data/deleted_ids` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/revision` to the response with the `200` status

---

[Operation](https://skmtc.dev/statsig/apis/console-api/docs/console/v1/dashboards/:id/widgets/put.md) - [API](https://skmtc.dev/statsig/apis/console-api.md) - [Page](https://skmtc.dev/statsig/apis/console-api/changes/console/v1/dashboards/:id/widgets/put)