Item (write)
item_writeChange DaVinci Resolve timeline item state: flags, markers, takes, names, speed, fades, and properties. Every write is read back to verify it took.
Instructions
Change item state; may overwrite current values. Every change is read back from Resolve (receipt.verified=false means it did not take). op.action (params; * = required):
add_flag(items*, color*): Add a colored flag to items.
add_item_marker(item*, frame*, color, name, note, duration, custom_data): Add a marker on a timeline item.
add_take(item*, clip*, start_frame, end_frame): Add a Media Pool clip as a new take (creates the take selector if needed).
add_transition(item*, options*): Add a transition at the start or end of an item (needs source handles).
clear_flags(items*, color): Clear flags of one color, or all flags, on items.
copy_properties(source*, targets*, keys): Copy properties from one item to many (timeline snapshot taken first).
finalize_takes(item*): Finalize the take selection (the selected take replaces the selector).
flatten_multicam(item*, grade): Flatten a multicam item into its active angle (timeline snapshot taken first).
select_take(item*, index*): Select a take by 1-based index.
set_clip_color(items*, color): Set the clip color on items, or clear it when no color is given.
set_enabled(items*, enabled*): Enable or disable clips.
set_fades(items*, fades*): Set fade-in / fade-out durations (frames) on one or many items.
set_name(item*, name*): Rename a timeline item.
set_output_blanking(item*, blanking*): Set per-item output blanking in pixels (Top/Bottom/Left/Right).
set_properties(items*, properties*): Set properties on one or many items; each key is read back per item.
set_speed(items*, speed*): Set clip speed (Percentage, PitchCorrection...) on one or many items.
set_use_timeline_blanking(item*, use_timeline*): Choose between the timeline output blanking and the item's own.
smart_switch(item*, settings): Run Multicam Smart Switch on a multicam item (synchronous, may take minutes).
stabilize(items*): Run the stabilizer on items (can be slow; no read-back exists).
update_marker_custom_data(item*, frame*, custom_data*): Update the custom data string of an item marker. Calls known in advance (a sequence, the same change on several items): ONE batch_run.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | {action, ...params}. Parameters per action: see the description or this server's describe_action tool. | |
| dry_run | No | true: return the planned effect, change nothing. | |
| snapshot | No | true: back up the timeline/project first; omitted: server policy. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | ||
| plan | No | ||
| status | Yes | ||
| receipt | No |