Command · Edit Marker
marker.update
Changes the sequence marker at an index (as listed by sequence.summary): any of its time, duration, name, comment, colour, type, URL and frame target.
- v1
- Capability EditSequence
- Tool
marker_update - Alias
markers.update
Request
{
"command": "marker.update",
"params": {
"colorIndex": 1,
"index": 0,
"name": "Interview"
}
}Parameters
colorIndexinteger (0..15)- Marker colour index (Premiere's colours are 0-7).
commentstring- Marker comment.
durationinteger | string- New length (0 = a point marker). Timecode in the sequence's rate ("00:01:02:03") or ticks.
highlightobject | null- C.15: a highlight finder's verdict on the marked moment (the Highlights panel reads it). null removes it.
indexinteger (0..)Required- Marker index.
namestring- Marker name.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
targetstring- Web link frame target.
timeinteger | string- New start. Timecode in the sequence's rate ("00:01:02:03") or ticks.
type`comment` | `chapter` | `segmentation` | `webLink`- Premiere's marker type. Default comment.
urlstring- Web link URL (http or https).
Discussion
Changes the sequence marker at an index (as listed by sequence.summary): any of its time, duration, name, comment, colour, type, URL and frame target. Keys left out keep their values; the markers stay sorted by start.
Run it with wabcut-cli cmd <project> --json, from an MCP client as marker_update, or from an extension. See Edit commands for requests, references and results.
See also
marker.*
- marker.add
Add Marker. Adds a sequence marker.
- marker.clearAll
Clear All Markers. Removes every marker of the sequence (Premiere's Clear All Markers).
- marker.clearInAndOut
Clear In and Out. Clears the sequence In and Out marks.
- marker.list
List Markers. The sequence's markers in time order with all their fields: index (what marker.update and marker.remove take), start, duration, name, comment, colour, type, web link, and the highlight a highlight finder wrote (score, confidence, reasons, peak, source; null when none).
- marker.markIn
Mark In. Sets the sequence In mark at the start of the frame at a time.
- marker.markOut
Mark Out. Sets the sequence Out mark at the end of the frame at a time (the frame is included).
- marker.remove
Remove Marker. Removes the sequence marker at an index (as listed by sequence.summary).