Craft icon

Craft

Interact with your Craft documents via the API

Block → Move Blocks

AI-generated

Summary

Move one or more blocks within a Craft document to a specified position such as start, end, before, or after another block.

Inputs

  • Input Mode — Choose whether to input block IDs as a JSON array or via a form with multiple entries.
  • Block IDs (required) — Specify the IDs of the blocks to move either as a JSON array or multiple string entries depending on the Input Mode.
  • Move Position (required) — Define the target position to move the blocks to, with options for Start of Page, End of Page, Before Block, or After Block. Additional parameters include Page ID and Daily Note Date for start or end positions, and Sibling ID for before or after positions.

Output shape

an array of JSON objects representing the outcome for each moved block

Returns results mapped to each input item. Errors per item will be output if continueOnFail is enabled.

Examples

Example 1: Move blocks with IDs 'id1' and 'id2' to the start of a page with Page ID 'page123'

Set Input Mode to JSON, provide ['id1','id2'] as Block IDs, and set Move Position Type to Start of Page with Page ID 'page123'.

Discussion