Skip to content

Commands

track.remove

Removes a track, and its items when with_items is true.

Last updated:

Removes the track. A track with items is refused with E_NOT_EMPTY unless with_items is true, in which case its items are removed too.

Arguments#

ArgumentTypeRequiredDescription
track_idstringyes
with_itemsbooleannoRemove the items of the track too.

Example#

As one operation of an edit batch (the edit tool of MCP, vukem-video edit --ops, or POST /api/v1/projects/{id}/edit):

JSON
{
  "op": "track.remove",
  "args": {
    "track_id": "trk_f6g7h8j9k0",
    "with_items": true
  }
}

Errors#

E_NOT_FOUND, E_NOT_EMPTY

Scope and phase#

Scope edit, phase prototype. Run vukem-video command:help track.remove for the same description from the binary.