Update project
update_projectUpdate a project's metadata: rename, change description, move to a different folder, or change aspect ratio.
Only fields you provide are changed. To move a project to the workspace root, pass folder_id="" (or "root").
Aspect ratio: pass any "W:H" (positive integers). The canvas is fit inside 1920×1080 keeping the ratio, so element pixel coordinates use the resulting canvas. Common values:
"16:9" → 1920×1080 (landscape, YouTube/web — default)
"9:16" → 608×1080 (portrait — TikTok/Reels/Shorts)
"1:1" → 1080×1080 (square — Instagram feed)
"3:4" → 810×1080 (portrait card)
"4:5" → 864×1080 (portrait — Instagram feed)
Element coordinates are stored as fractions of the canvas, so existing elements reflow to the new canvas automatically — no element coordinates are rewritten.
Brand kit: brand_kit_id sets the kit this project is built with (an id from find(type='brand_kits')); 'default' makes it follow the workspace default kit; 'none' takes the kit off, so the project is made without one. It changes the kit get_design_guide({project_id}) returns; elements already placed keep their colors, fonts and logos until you edit them. The reply's brand_kit is {id, name, follows_default}, or null with no_kit true when the project has no kit (null without no_kit: the workspace has no kit). Only workspace editors and admins can change it.
Tags: add_tags / remove_tags change the project's tags (the home page Tags menu and filter), by NAME. Adding a name the workspace doesn't have creates it; existing names match ignoring case. List them with find(type='tags'). Only workspace editors and admins can change tags. To tag many projects, loop update_project over their ids in run_script. When tags are given, the reply also has tags (the project's full list after the change), created_tags and not_found_tags (remove_tags names the workspace doesn't have).
Concurrency: whole-project mutation (conflict domain: the entire project) — serialize. Do not run it in parallel with ANY other mutation on the same project_id, including element/voiceover edits; run them one at a time. (Mutations to different projects run in parallel freely.)
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": {
"project_id": "<project_id>"
},
"name": "update_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | New project title | |
| add_tags | No | Tag names to add; missing tags are created. | |
| folder_id | No | New folder ID. Pass '' (empty string) to move to workspace root. | |
| project_id | Yes | The project ID to update | |
| description | No | New description | |
| remove_tags | No | Tag names to remove. | |
| aspect_ratio | No | New aspect ratio as 'W:H' (positive integers). Common: '16:9' landscape, '9:16'/'4:5'/'3:4' portrait, '1:1' square. | |
| brand_kit_id | No | Brand kit for this project: an id from find(type='brand_kits'), 'default' to follow the workspace default kit, or 'none' for no brand kit. |