---
title: "Changes to Add Widget"
method: POST
path: "/api/v1/dashboards/{dashboard_id}/widgets"
---

# Changes to Add Widget

`POST /api/v1/dashboards/{dashboard_id}/widgets`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 6 revisions.

- **2026-08-27** `db5ab8f1fcef` — 1 breaking, 21 info

## Changes

- **2026-08-27** `db5ab8f1fcef` — 1 breaking, 21 info
  - request property `widget_type` was restricted to a list of enum values
  - added the new optional request property `config`
  - added the new optional request property `footer`
  - added the new optional request property `subtitle`
  - added the new optional request property `title`
  - added the new optional request property `widget_kind`
  - the request property `position_config` became optional
  - the request property `report_id` became optional
  - added the new `bar` enum value to the request property `widget_type`
  - added the new `combi` enum value to the request property `widget_type`
  - added the new `donut` enum value to the request property `widget_type`
  - added the new `funnel` enum value to the request property `widget_type`
  - added the new `gauge` enum value to the request property `widget_type`
  - added the new `line` enum value to the request property `widget_type`
  - added the new `metric` enum value to the request property `widget_type`
  - added the new `pie` enum value to the request property `widget_type`
  - added the new `scatter` enum value to the request property `widget_type`
  - added the new `table` enum value to the request property `widget_type`
  - added the new `text` enum value to the request property `widget_type`
  - added the new `treemap` enum value to the request property `widget_type`
  - added the new `waterfall` enum value to the request property `widget_type`
  - request property `report_id` list-of-types was widened by adding types `null` to media type `application/json`

---

[Operation](https://skmtc.dev/ninjavan/apis/salesforce-sales-cloud-replacement/docs/api/v1/dashboards/:dashboard_id/widgets/post.md) · [API](https://skmtc.dev/ninjavan/apis/salesforce-sales-cloud-replacement.md) · [Page](https://skmtc.dev/ninjavan/apis/salesforce-sales-cloud-replacement/changes/api/v1/dashboards/:dashboard_id/widgets/post)