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

# PATCH /api/v1/boards-and-blocks

`PATCH /api/v1/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
    - `deletedColumnCalculations` string[] — The board deleted column calculations
    - `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
    - `updatedColumnCalculations` object — The board updated column calculations
    - `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
    - `createdBy` string, required — The id for user who created this block
    - `deleteAt` integer — The deleted time. 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
  - `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
    - `columnCalculations` object — The calculations on the board's cards
    - `createAt` integer, required — The creation time
    - `createdBy` string, required — The ID of the user that created the board
    - `deleteAt` integer — The deleted time. 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

## Other responses

- `default` — internal error

## Changes

- **2022-03-22** `cdfed1e96572` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mattermost/apis/focalboard-server/changes/api/v1/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/e8bd8dee7882/schema)