Create template signature block
create-template-signature-blockAdd a signature block to a template, bound either to one of its parties or to a single signatory.
Use this tool when:
The user wants a party to have a place to sign on documents created from the template
The user wants one specific signatory to have their own place to sign
You are building up a template and need to add signing slots
Pass exactly one of party_uuid or document_user_uuid. A party-bound block is signed by every signatory of that
party, whoever they turn out to be on a document created from the template; a user-bound block is signed only by
the signatory it names. Use get-template-info with include=["parties", "signatories"] to discover the available
parties and signatories and their UUIDs.
A user-bound block requires a signatory that belongs to a party, because the block records that party alongside the signatory.
IMPORTANT: this is only the first of two steps. Creating the signature block does NOT place it in the template
content, so on its own it will not appear on any document. To make it show up, reference the returned ref_uuid
in the template body (via replace-template-content) from a signature container, which houses one or more blocks:
<div data-signatures data-align="left"><span data-signature-block data-ref-uuid="<signature block ref_uuid>"></span></div>A block is always placed inside such a container, even when it is the only one.
Until it is referenced in the content the block exists but is rendered nowhere. The same two-step pattern applies
to dynamic fields (create-template-dynamic-field, then <span data-dynamic-field data-ref-uuid="...">).
style (regular or minimal) and scale (50–150, percent) are optional and default to "regular" and 100.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"template_uuid": "<template_uuid>"
},
"name": "create-template-signature-block"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scale | No | Scale percentage of the signature block (50–150). Defaults to 100. | |
| style | No | Visual style of the signature block. Defaults to "regular". | |
| party_uuid | No | UUID of the party this signature block belongs to, so that every signatory of that party signs it. Must be a party already on the template (use get-template-info to find it). Provide either this or document_user_uuid, not both. | |
| template_uuid | Yes | UUID of the template to add the signature block to | |
| document_user_uuid | No | UUID of the single signatory this signature block is bound to. Must be a signatory already on the template and belonging to a party (use get-template-info with include=["signatories"] to find it). Provide either this or party_uuid, not both. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | No | Do not show to the user unless they ask for it | |
| scale | No | Scale percentage of the signature block (50–150) | |
| style | No | Visual style of the signature block | |
| ref_uuid | No | A static reference identifier, allowing signature blocks in documents to be matched to their corresponding block in the source template. Do not show to the user unless they ask for it | |
| party_uuid | No | UUID of the party this signature block belongs to. Do not show to the user unless they ask for it | |
| _entity_type | No | Only relevant for tooling. Do not show to the user | |
| document_user_uuid | No | UUID of the single signatory this signature block is bound to. Absent when the block is bound to its party instead, in which case every signatory of that party signs it. Do not show to the user unless they ask for it |