---
title: "PATCH /boards-and-blocks"
method: PATCH
path: "/boards-and-blocks"
---

# PATCH /boards-and-blocks

`PATCH /boards-and-blocks`

Patches a set of related boards and blocks

## Request body

- PatchBoardsAndBlocks — PatchBoardsAndBlocks is used to patch multiple boards and blocks on a single request
  - `blockIDs` string[], required — The block IDs to patch
  - `blockPatches` BlockPatch[], required — The block patches
    - `boardId` string — The board id that the block belongs to
    - `deletedFields` string[] — The block removed fields
    - `parentId` string — The id for this block's parent block. Empty for root blocks
    - `schema` integer — The schema version of this block
    - `title` string — The display title
    - `type` string
    - `updatedFields` object — The block updated fields
  - `boardIDs` string[], required — The board IDs to patch
  - `boardPatches` BoardPatch[], required — The board patches
    - `deletedCardProperties` string[] — The board removed card properties
    - `deletedProperties` string[] — The board removed properties
    - `description` string — The description of the board
    - `icon` string — The icon of the board
    - `showDescription` boolean — Indicates if the board shows the description on the interface
    - `title` string — The title of the board
    - `type` string
    - `updatedCardProperties` object[] — The board updated card properties
    - `updatedProperties` object — The board updated properties

## Response `200`

success

- BoardsAndBlocks — BoardsAndBlocks is used to operate over boards and blocks at the same time
  - `blocks` Block[] — The blocks
    - `boardId` string, required — The board id that the block belongs to
    - `createAt` integer, required — The creation time in miliseconds since the current epoch
    - `createdBy` string, required — The id for user who created this block
    - `deleteAt` integer — The deleted time in miliseconds since the current epoch. Set to indicate this block is deleted
    - `fields` object — The block fields
    - `id` string, required — The id for this block
    - `modifiedBy` string, required — The id for user who last modified this block
    - `parentId` string — The id for this block's parent block. Empty for root blocks
    - `schema` integer, required — The schema version of this block
    - `title` string — The display title
    - `type` string, required
    - `updateAt` integer, required — The last modified time in miliseconds since the current epoch
  - `boards` Board[] — The boards
    - `cardProperties` object[] — The properties of the board cards
    - `channelId` string — The ID of the channel that the board was created from
    - `createAt` integer, required — The creation time in miliseconds since the current epoch
    - `createdBy` string, required — The ID of the user that created the board
    - `deleteAt` integer — The deleted time in miliseconds since the current epoch. Set to indicate this block is deleted
    - `description` string — The description of the board
    - `icon` string — The icon of the board
    - `id` string, required — The ID for the board
    - `isTemplate` boolean — Marks the template boards
    - `modifiedBy` string, required — The ID of the last user that updated the board
    - `properties` object — The properties of the board
    - `showDescription` boolean — Indicates if the board shows the description on the interface
    - `teamId` string, required — The ID of the team that the board belongs to
    - `templateVersion` integer — Marks the template boards
    - `title` string — The title of the board
    - `type` string, required
    - `updateAt` integer, required — The last modified time in miliseconds since the current epoch

## Other responses

- `default` — internal error

## Changes

- **2022-04-13** `8e122d5d731c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mattermost/apis/focalboard-server/changes/boards-and-blocks/patch.md)

---

[API](https://skmtc.dev/mattermost/apis/focalboard-server.md) · [All operations](https://skmtc.dev/mattermost/apis/focalboard-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mattermost/focalboard-server/revisions/c529a648bb5b/schema)