---
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 — Position and size of a widget on a dashboard grid.
      - `x` integer, required — Column position, 1-based
      - `y` 1 | 2 | 3, required — Row position
      - `w` 1 | 2 | 3, required — Width in grid units
      - `h` 1 | 2 | 3, required — Height in grid units

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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