---
title: "Changes to Create Widget"
method: POST
path: "/v1/widgets"
---

# Changes to Create Widget

`POST /v1/widgets`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 60 revisions.

- **2026-09-24** `82e1eddb5e18`: 6 info
- **2026-09-18** `54341b2e924c`: 3 breaking
- **2026-09-03** `aa501502e1fc`: 1 info
- **2026-08-27** `a52d6f90f25a`: 15 info
- **2026-08-06** `24eaf0880543`: 5 info
- **2026-07-31** `4309a961859b`: 2 info
- **2026-07-26** `44d183272ce1`: 1 info

## Changes

- **2026-09-24** `82e1eddb5e18`: 6 info
  - added the new optional request property `center_label/anyOf[subschema #1: WidgetCenterLabelModel]/benchmark`
  - added the new optional request property `center_label/anyOf[subschema #1: WidgetCenterLabelModel]/compare_previous`
  - added the new optional request property `center_label/anyOf[subschema #1: WidgetCenterLabelModel]/unit`
  - added the optional property `center_label/anyOf[subschema #1: WidgetCenterLabelModel]/benchmark` to the response with the `200` status
  - added the optional property `center_label/anyOf[subschema #1: WidgetCenterLabelModel]/compare_previous` to the response with the `200` status
  - added the optional property `center_label/anyOf[subschema #1: WidgetCenterLabelModel]/unit` to the response with the `200` status
- **2026-09-18** `54341b2e924c`: 3 breaking
  - the request property `dashboard_id` became required
  - request property `dashboard_id` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `dashboard_id` request property's minLength was increased from `0` to `1`
- **2026-09-03** `aa501502e1fc`: 1 info
  - added the new optional `header` request parameter `X-Organization-Id`
- **2026-08-27** `a52d6f90f25a`: 15 info
  - added the new optional request property `center_label`
  - added the new optional request property `color_overrides`
  - added the new optional request property `show_legend`
  - added the optional property `center_label` to the response with the `200` status
  - added the optional property `color_overrides` to the response with the `200` status
  - added the optional property `show_legend` to the response with the `200` status
  - removed the `1.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/h` response property for the response status `200`
  - removed the `1.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/w` response property for the response status `200`
  - removed the `1.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/y` response property for the response status `200`
  - removed the `2.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/h` response property for the response status `200`
  - removed the `2.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/w` response property for the response status `200`
  - removed the `2.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/y` response property for the response status `200`
  - removed the `3.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/h` response property for the response status `200`
  - removed the `3.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/w` response property for the response status `200`
  - removed the `3.00` enum value from the `layout/anyOf[subschema #1: WidgetLayoutModel]/y` response property for the response status `200`
- **2026-08-06** `24eaf0880543`: 5 info
  - added the new optional request property `metrics/items/threshold_operator`
  - added the new optional request property `metrics/items/threshold_value`
  - added `subschema #2` to the `group_by` request property `anyOf` list
  - added the optional property `widget_metrics/items/threshold_operator` to the response with the `200` status
  - added the optional property `widget_metrics/items/threshold_value` to the response with the `200` status
- **2026-07-31** `4309a961859b`: 2 info
  - added the new `distribution` enum value to the request property `aggregation/items/`
  - added the new `histogram` enum value to the request property `chart_type`
- **2026-07-26** `44d183272ce1`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getbluejay/apis/bluejay-api/docs/v1/widgets/post.md) - [API](https://skmtc.dev/getbluejay/apis/bluejay-api.md) - [Page](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/widgets/post)