Changes data

quotecloud_move_block

Move one block using the exact validated target/position grammar. PDF targets require placement pdf-overlay, target.pageId plus target.pdfSubpageId from quotecloud_inspect_structure, and normalized overlay geometry. Moving away from a PDF removes its PDF overlay geometry. Checks block, source-parent, and target-parent revisions and acquires all corresponding locks.

Inputs

documentIdRequired
Convex document ID or company-scoped numeric display ID. string
blockIdRequired
string
revisionTokenOptional
Document revisionToken from quotecloud_inspect_structure. Selects the normalized argument family, which works in either contentMode; the write is refused with a *_revision_conflict if the document moved since it was read. string
expectedRevisionOptional
number
placementRequired
one of: header, footer, grid, grid-floating, canvas, pdf-overlay
targetRequired
object
positionOptional
object
overlayOptional
object
expectedSourceParentRevisionOptional
number
expectedTargetParentRevisionOptional
number
lockTokenRequired
Stable opaque token for this agent edit session. Reuse it to heartbeat owned element locks. string