create_clause_reference
Create a clause reference record in the database. Returns a clauseReferenceId that you can embed in document content using {{clauseRef:CLAUSE_REF_ID}} (in extended Markdown) or as a { type: “clauseReference”, attrs: { clauseReferenceId: ”…” } } node (in TipTap JSON). WORKFLOW: 1. Call list_clause_blocks_for_reference to find the target clause’s blockId and hierarchy. 2. Call this tool with the target documentId, blockId, and hierarchy. 3. Use the returned clauseReferenceId in your content. Local references: documentId = the document you are writing content into. Cross-document references: documentId = the OTHER document that contains the target clause.
Parameters
string
required
ID of the document that CONTAINS the target clause block.
string
required
The block ID (attrs.id) of the target clause block.
string
required
The target clause’s hierarchy EXACTLY— 1-based and dot-joined, e.g. “2”, “1.2”, “1.2.3”. Never invent or renumber it: it is the fallback used to re-find the clause if its block is ever recreated, and a wrong value breaks that silently.