---
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
  - `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
  - `tags` string[] — List of tags associated to the layout
  - `metadata` unknown[] — List of meta informations sur as "selectedColorColumn", or ...
    - unknown

## Response `204`

Dashboard layout saved

---

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