update-blockfreeStored Metrics & ReportingUpdate Block Tool
Update an existing AI-pinned workspace block — payload, source, and/or position. The edit always resets the block to pending-review state, so the user sees the revision in the canvas and decides whether to keep or discard. Cannot change a block's kind. Cannot edit human-authored blocks.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| block_id | integer | required | The ID of the block to update. Get from a prior pin-to-workspace response or from get-workspace. |
| payload | object | optional | Replacement payload for the block (kind-specific shape, same as pin-to-workspace). |
| source | object | optional | Replacement source binding for data-bound blocks: { tool, params, mode: live|snapshot, snapshot_data?, snapshotted_at? }. |
| position | integer | optional | 1-based target position to move the block to. Sibling blocks shift to keep positions sequential. Clamped to valid range. |
Plan access
Available on the free tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).
See plans