Changes data

quotecloud_insert_block

Insert a documented block. To place a compatible ordinary block on an embedded PDF, use placement pdf-overlay, target.pageId plus target.pdfSubpageId from quotecloud_inspect_structure, and normalized overlay geometry. Placement uses the exact inspect/validate ancestry vocabulary; detached containers/columns cannot be targets. Acquires the editor lease and parent/block locks.

Inputs

documentIdRequired

Convex document ID or company-scoped numeric display ID. 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

blockIdRequired

string

blockTypeRequired

string

placementRequired

one of: header, footer, grid, grid-floating, canvas, pdf-overlay

targetRequired

object

positionOptional

object

overlayOptional

object

payloadRequired

object

expectedParentRevisionOptional

number

lockTokenRequired

Stable opaque token for this agent edit session. Reuse it to heartbeat owned element locks. string