Change a short
update_shortChange one short: its first or last word (from, to), whole sentences more or fewer at each end (extend), words to cut inside it (trims), the hook title, the layout (auto, stack, camera, screen), the crop over the screen recording, where the camera's crop sits across a landscape webcam (camera_focus, 0 left to 1 right, 0.5 the centre), the end card's call to action and web address for this short alone (cta, at most 32 characters, and website, in place of the brand kit's; null goes back to the kit's), the music, whether it shows the long video's stills and graphics (visuals: auto, the default, or none), its status (accepted, rejected) or its place in the list. Returns it measured again; refuses more than 56.8 s of speech.
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>",
"moment_id": "<moment_id>"
},
"name": "update_short"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | New last word | |
| cta | No | This short's call to action on its end card, at most 32 characters (e.g. Try the free calculator), in place of the brand kit's. null or empty goes back to the kit's | |
| from | No | New first word | |
| music | No | A track_id from find_music, "default" for the default, null for none | |
| order | No | ||
| title | No | Hook title, at most 8 words; empty for none | |
| trims | No | Words to cut inside the short (replaces the list) | |
| extend | No | Whole sentences to add (+) or drop (-) at each end | |
| layout | No | ||
| status | No | ||
| visuals | No | Whether the short shows the long video's stills and graphics on its words, with the face in a band above them: auto (the default) or none | |
| website | No | This short's web address on its end card, as it should read (e.g. acme.studio/calculator), at most 80 characters, in place of the brand kit's website. null or empty goes back to the kit's | |
| moment_id | Yes | From suggest_shorts or list_shorts | |
| project_id | Yes | From create_project | |
| screen_crop | No | Normalised window over the screen recording; null for centred | |
| camera_focus | No | Where the camera's crop sits across its picture, so the presenter's face stays in a 9:16 short: 0 the left edge, 1 the right, 0.5 the centre (the default). null goes back to the centre |