Changes data

quotecloud_set_block_link_id

Give any block an API Link ID, a stable handle for Zapier/MCP, such as Upsert Document Image's Image Target. Setting it on a template makes documents created afterwards inherit it; existing documents are unaffected. quotecloud_inspect_structure reports every block's blockLinkId. Address by blockId or its existing blockLinkId and supply the current revisionToken. Omit linkId to generate api_link_ plus 10 alphanumerics, supply a unique custom name, or pass null to clear it. Custom names are trimmed, start with a letter or digit, use only letters, digits, underscores or hyphens, and are at most 64 characters. An unchanged ID returns alreadyApplied without writing or changing revisions. Sent and read-only documents are refused.

Inputs

documentIdRequired
Convex document ID or company-scoped numeric display ID. string
blockIdOptional
The block id reported by quotecloud_inspect_structure. Supply this or blockLinkId, not both. string
blockLinkIdOptional
The block’s API Link ID (BlockData.apiLinkId), the short handle set in the editor. Supply this or blockId, not both; a link id shared by several blocks is refused as ambiguous. string
revisionTokenRequired
string
linkIdOptional
string
lockTokenOptional
Stable opaque token for this agent edit session. Reuse it to heartbeat owned element locks. string