Update clueprint
update_clueprintUpdate a clueprint's metadata and/or file contents in one call.
Metadata fields (name, description, tags, visibility, thumbnail_path) are applied as a patch — only the fields you pass change. Pass at least one to update metadata.
files is a list of file mutations:
Write text:
{ path, content }Write binary:
{ path, content, encoding: "base64" }Write from URL:
{ path, source_url }(presigned URL, e.g. from get_clip with save=true)Delete:
{ path, content: null }
You can mix writes and deletes in a single call. Existing files at the same path are overwritten.
brand_locked: true keeps the clueprint's own colors, fonts and logos for projects in this workspace; false (the default) re-skins them to each project's brand kit. Only this workspace's clueprints; a community clueprint is always re-skinned.
decisions records the build-time choices create_clueprint left pending, after you ask the user: animation_modes / image_modes ({id: mode}), voiceover_policies ({source_clip_id: policy}), split_decision, slide_count_strategy, allowed_element_types, the *_by_role variants for all-slides sources ({role: ...} from the *_by_role groups), and finalize_layout_texts: true (once every layouts/-/layout.md exists). Each applies on its own; failures come back in decision_errors.
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": {
"clueprint_id": "<clueprint_id>"
},
"name": "update_clueprint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New name. | |
| tags | No | New tags (replaces existing). | |
| files | No | File mutations — writes and deletes. Empty/omitted for metadata-only updates. | |
| decisions | No | Build-time decisions to record (see the description). | |
| visibility | No | New visibility. | |
| description | No | New description. | |
| brand_locked | No | true: projects built from it keep its own colors, fonts and logos; false: re-skinned to each project's brand kit. | |
| clueprint_id | Yes | ID of the clueprint to update. | |
| thumbnail_path | No | Relative path of a screenshot in the clueprint to use as thumbnail (e.g. 'screenshots/title-slide.png'). |