Command · Add Marker
marker.add
Adds a sequence marker.
- v1
- Capability EditSequence
- Tool
marker_add - Alias
markers.add
Request
{
"command": "marker.add",
"params": {
"name": "Chapter 2",
"time": "00:01:00:00",
"type": "chapter"
}
}Parameters
colorIndexinteger (0..15)- Marker colour index.
commentstring- Marker comment.
durationinteger | string- Length for a range marker. Default 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.
namestring- Marker name.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
targetstring- Web link frame target.
timeinteger | stringRequired- Where the marker starts. 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
Adds a sequence marker. Premiere's marker colours are 0-7: green, red, purple, orange, yellow, white, blue, cyan.
Run it with wabcut-cli cmd <project> --json, from an MCP client as marker_add, or from an extension. See Edit commands for requests, references and results.
See also
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).
- marker.update
Edit Marker. 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.