Craft Documents icon

Craft Documents

Interact with Craft Multi-Document API - manage documents, blocks, collections, and search

Actions14

Block → Update

AI-generated

Summary

Update one or more blocks in a Craft document by specifying their unique IDs and desired property changes such as markdown content, text style, font, list style, indentation level, and highlight color.

Inputs

  • Blocks to Update (required) — Multiple blocks to update, each requiring a Block ID; optionally set new markdown content, text style, font, list style, indentation level, and block highlight color (in hex). Leaving optional fields empty retains current values.

Output shape

The updated block objects as returned by the API (typically a JSON array of updated blocks).

Supports batch updating multiple blocks in one request. Each block update includes only specified fields; unspecified fields remain unchanged.

Examples

Example 1: Update multiple blocks' contents and styles in one call

Provide an array of objects each with 'id' (block UUID) and optional fields like 'markdown' for new text, 'textStyle' for headings or body text, and 'color' for highlight in hex.

Links

Discussion