Craft Documents icon

Craft Documents

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

Block → Move

AI-generated

Summary

Move specified blocks within or across Craft documents to a new position: start, end, before, or after a reference block.

Inputs

  • Block IDs (required) — IDs of the blocks to move, provided as comma-separated values or a JSON array.
  • Position Type (required) — Specifies where to move the blocks: to the start or end of the document, or before/after a specific block.
  • Target Document Name or ID (required) — The target document to move the blocks to, selected from a list or specified by expression.
  • Reference Block ID — The ID of the block relative to which the moved blocks will be positioned; required if Position Type is 'before' or 'after'.

Output shape

a single JSON object representing the result of the move operation

The response reflects the API's confirmation of the move action. No pagination or additional fields are indicated.

Examples

Example 1: Move multiple blocks to the start of a specified document

Provide block IDs as a comma-separated list, select 'start' for Position Type, and choose the target document from the dropdown.

Links

Discussion