---
title: "Update Dashboard Layout"
method: PUT
path: "/v1/dashboards/{dashboard_id}/layout"
tags: ["Dashboards"]
---

# Update Dashboard Layout

`PUT /v1/dashboards/{dashboard_id}/layout`

Set widget positions/sizes on a dashboard. Widgets not linked to the dashboard are ignored.

## Path parameters

- `dashboard_id` string, required

## Headers

- `X-API-Key` string, required

## Request body

- UpdateLayoutBody
  - `layouts` LayoutItem[], required — Layout per widget already linked to the dashboard
    - `widget_id` string, required
    - `layout` WidgetLayoutModel, required — Where a widget sits on a dashboard and how big it is. The field names are older than the grid they describe: x is the row and y is the column, both 1-based. The dashboard is six columns wide, and height is counted in 50px steps, so h=6 is the 300px a widget used to be and the range 2..18 is 100px..900px.
      - `x` integer, required — Row, 1-based, top to bottom
      - `y` integer, required — Column within the row, 1..6
      - `w` integer, required — Width in columns, 1..6
      - `h` integer, required — Height in 50px steps, 2..18 (100px..900px)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `a52d6f90f25a` — 9 breaking, 6 warning
  - removed the enum value `1.00` of the request property `layouts/items/layout/h`
  - removed the enum value `1.00` of the request property `layouts/items/layout/w`
  - removed the enum value `1.00` of the request property `layouts/items/layout/y`
  - removed the enum value `2.00` of the request property `layouts/items/layout/h`
  - …11 more
- **2026-07-26** `44d183272ce1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/dashboards/:dashboard_id/layout/put.md)

---

[API](https://skmtc.dev/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.dev/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/bf69ab7268a4/schema)