Manage Markers

list, get, create, batch_create, bulk_create, update, batch_update, bulk_update, delete, batch_delete, or bulk_delete

Optional timeline item (clip) id or prefix. When set, creates/identifies a clip marker anchored to that clip instead of the timeline ruler. Use for notes that should travel with a clip across move/trim/split/duplicate. Omit for a ruler marker.

Markers to create in one call (required for batch_create/bulk_create)

Markers to update in one call (required for batch_update/bulk_update)

Target marker prefix id from action=list (required for get/update; delete takes this or markerIds)

Integer timeline frame to anchor the marker at (required for create unless transcriptSegments is used). When itemId is set this is still the timeline frame — the tool converts internally so the marker stays glued to the clip's source content. For evidence-bound requests, do not…

Several marker prefix ids to remove in one delete/batch_delete call. Use this instead of repeated single deletes.

Existing project ID from the editor URL or list_projects. Pass this when continuing work on an existing project and the external MCP session is not already targeted.

Optional label prefix when transcriptSegments derives the note body

Timeline ID or prefix to target without switching active timelines. Use for non-active timeline marker work.

Duration in frames (0 = point marker, default 0)