---
title: "Add a layout"
method: POST
path: "/app/layouts/"
tags: ["Layouts"]
---

# Add a layout

`POST /app/layouts/`

## Request body

- object
  - `name` string, required — Name of the configuration
  - `projectId` string, required — Id of the project linked to the configuration
  - `dataProviderId` string, required — Id of the data provider linked to the project id
  - `description` string
  - `layout` object[], required — Dashboard layout, list of widgets with their position and configuration
    - `widgetKey` string, required — Key of the widget
    - `x` integer, required — x position of the widget
    - `y` integer, required — y position of the widget
    - `width` integer, required — width of the widget
    - `height` integer, required — height of the widget
    - `config` object, nullable — Configuration of the widget
    - `localFilters` object[], nullable — Filters applied to the widget
  - `lastLayoutSaved` boolean — If true, the layout will be loaded by default If a layout with lastLayoutSaved=true already exists, it will be replaced by the new one
  - `selectedColorColumn` string, nullable — Column selected to be used as color

## Response `204`

Dashboard layout saved

---

[API](https://skmtc.net/debiai/apis/debiai-backend-api.md) · [All operations](https://skmtc.net/debiai/apis/debiai-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debiai/debiai-backend-api/revisions/c53e3bf3be9b/schema)