keep_design
Destructive
Save a Kiln-built make to this computer and return the local file path needed for slicing, printing, or export.
Instructions
Keep a make that Kiln's servers built: save its file to this computer.
A make from one of Kiln's served tools (a coaster, a textured part,
a decorated model) is built on Kiln's servers and shown on the
stage. Looking at it and changing it are free. Call this when the
user wants to KEEP it: to slice, print or export it. It saves the
full-quality file on this computer and returns its path
(``mesh_path``), which every local tool takes.
On the Free plan a keep counts toward that kind of make's monthly
allowance, and the answer says how many are left (``keep``). Paid
plans keep without limit. A make is only ever counted once.
Args:
artifact_token: The token of the make to keep. It is in the
make's own answer, under ``made_on_kiln_servers``.
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": {
"artifact_token": "<artifact_token>"
},
"name": "keep_design"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| artifact_token | Yes | The token of the make to keep. It is in the make's own answer, under ``made_on_kiln_servers``. |