sign_design_release
Sign and persist an immutable named release of a design version to preserve provenance and mark it as distributable.
Instructions
Sign and persist an immutable named release of a version.
Needs Kiln Pro.
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": {
"design_id": "<design_id>",
"version_id": "<version_id>",
"name": "<name>"
},
"name": "sign_design_release"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The release name, e.g. ``1.0.0`` (semver), ``2026.4.16`` (calendar) or any other text (arbitrary). A name already used for this design is refused. | |
| ancestry | No | Optional echo of the version's lineage, as version ids from root to this version. Omit it to sign the recorded lineage; a list that disagrees is refused (``ANCESTRY_MISMATCH``). | |
| outcomes | No | Optional echo of the print outcomes recorded against the version. Omit it to sign the record; a list that disagrees is refused (``OUTCOMES_MISMATCH``). | |
| design_id | Yes | Id of the design the release belongs to. | |
| signed_by | No | Who signs, recorded as the signer. Omit it to use the caller's own identity: on Kiln's servers the signed-in account (a different name is refused), locally the declared operator or the computer's user name. | |
| provenance | No | Your own metadata to carry in the signed manifest. Keys Kiln writes itself (``assembly_manual``, ``spec_receipt``, ``reference_grade``) are dropped and named in ``discarded_provenance_keys``. | |
| version_id | Yes | Id of the design version being released. Its geometry, lineage and outcomes are read from Kiln's record. | |
| branch_name | No | Name of the branch the version was released from, recorded in the manifest. Omit it to record none. | |
| assembly_json | No | The assembly state, as returned by ``create_assembly`` / ``add_assembly_part`` / ``add_assembly_interface`` (JSON text or the object). When given, an assembly manual is made and its hash signed into the release; when the manual cannot be made for this caller the release signs without one and ``assembly_manual`` says why. Omit it for no manual. | |
| manual_branding | No | How Kiln's mark appears on the manual: ``"prominent"``, ``"subtle"``, ``"white_label"`` or ``"auto"``. Omit it for ``auto``, which follows the caller's plan. Used only with ``assembly_json``. | |
| manual_languages | No | Ordered language codes for the manual, e.g. ``["en", "de"]``; each language gets its own parts list and steps in one PDF. Omit it for one section in English. Used only with ``assembly_json``. | |
| mesh_fingerprint | No | Optional echo of the version's mesh fingerprint. Omit it to sign Kiln's own reading; a value that disagrees is refused (``FINGERPRINT_MISMATCH``). | |
| manual_co_brand_name | No | A maker name to show on the manual's cover in place of Kiln's line, where the plan permits co-branding; dropped otherwise. Used only with ``assembly_json``. | |
| manual_cover_language | No | Language code for the manual's cover. Omit it to use the first of ``manual_languages`` (or English). Used only with ``assembly_json``. | |
| manual_design_name_translations | No | Language code to product name, e.g. ``{"de": "Gelenkleuchte"}``, used as the cover title in that language; languages without one keep ``name``. Used only with ``assembly_json``. |