---
title: "Change the sections of a mashup"
method: PATCH
path: "/api/mashups/{id}"
tags: ["Mashups"]
---

# Change the sections of a mashup

`PATCH /api/mashups/{id}`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/mashups/{id}`
- Auth: HTTP bearer

Positions left out keep their plugin setting.

## Path parameters

- `id` integer, required

## Request body

- object
  - `contents` object: Plugin setting id by position
  - `health_notification_enabled` boolean

## Response `200`

Updated

- object
  - `data` Mashup
    - `version` string
    - `id` integer
    - `layout` '1x1' | '1Tx1B' | '1Lx1R' | '1Tx2B' | '2Tx1B' | '1Lx2R' | '2Lx1R' | '2x2' | '3x3'
    - `grid_config` object[], nullable: The cells of a 3x3 layout
      - `pos` string
      - `col` integer
      - `row` integer
      - `cs` integer
      - `rs` integer
    - `positions` string[]: The sections the layout has
    - `contents` object: Plugin setting id by position
    - `health_notification_enabled` boolean
    - `created_at` string, date_time
    - `updated_at` string, date_time

## Other responses

- `401`: Unauthorized
- `404`: Mashup belongs to another user
- `422`: A position the layout does not have

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)