---
title: "Merge a layout"
method: PATCH
path: "/matters/{matterId}/layouts/{itemId}"
tags: ["Layout Matter Items"]
---

# Merge a layout

`PATCH /matters/{matterId}/layouts/{itemId}`

Merges layout data.

## Path parameters

- `matterId` string, uuid, required
- `itemId` string, uuid, required

## Query parameters

- `skipFieldValidation` boolean

## Request body

- LayoutMatterItemApiPatch
  - `itemId` string, nullable — Unique identifier for the matter list item.
  - `layoutDesignId` string, nullable — Identifier of the layout design.
  - `index` integer — Zero-based index of the layout item.
  - `parentItemId` string, nullable — Unique identifier for the parent matter list item.
  - `parentId` string, nullable — Identifier of the parent matter list item specific to the provider.
  - `parentIndex` integer — Zero-based index of the parent matter list item.
  - `name` string, nullable — Name of the layout item.
  - `description` string, nullable — Brief description of the layout item.
  - `isRemoved` boolean — Boolean flag indicating if the layout item is to be removed.
  - `values` LayoutValue[], nullable — List of layout values.
    - `key` string, nullable
    - `value` string, nullable
    - `state` unknown
  - `events` LayoutEvent[], nullable — List of layout events.
    - `id` string, nullable
    - `appointmentId` string, nullable

## Response `202`

When the request is accepted. Returns a hypermedia 'Link' object of the layout item to be updated.

- Link
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable

## Other responses

- `400` — When the update payload does not contain an ID that matched the ID of the item requiring update.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — When the matter or a layout item with the specified ID does not exist.
- `503` — Service Unavailable

---

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