Change clip design
change_clip_designRe-render a clip with a new design while keeping the current video live until the draft post updates; published clips cannot change, and scheduled clips require confirmation.
Instructions
Re-renders one clip in a different design (template). The current video stays in place until the new one is ready, then the clip's draft post is updated. A published clip cannot be changed. If the clip's post is scheduled, it comes off the schedule: the first call then changes nothing and returns needs_confirmation, will_happen and confirmation, the change happens only on a second call with that confirmation, and unscheduled_post gives the time it had.
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": {
"clip_id": "<clip_id>",
"design_id": "<design_id>",
"idempotency_key": "<idempotency_key>"
},
"name": "change_clip_design"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip_id | Yes | The clip's id, from list_recordings or get_recording. | |
| design_id | Yes | A design id from list_recording_designs. | |
| account_id | No | ||
| confirmation | No | ||
| idempotency_key | Yes |