---
title: "POST /api/v1/blocks"
method: POST
path: "/api/v1/blocks"
---

# POST /api/v1/blocks

`POST /api/v1/blocks`

Insert or update blocks

## Request body

- Block[]
  - `createAt` integer, required — The creation time
  - `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
  - `rootId` string, required — The id for this block's root block
  - `schema` integer, required — The schema version of this block
  - `title` string — The display title
  - `type` string, required — The block type
  - `updateAt` integer, required — The last modified time

## Response `200`

success

## Other responses

- `default` — internal error

---

[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/ea12e9720c44/schema)