# item.delete

> Removes items, and optionally closes the freed space.

Source: https://alexgalhardo.github.io/vukem-video/docs/reference/commands/item.delete

Removes the items. With ripple track, every later item on each affected track moves earlier by the length freed on that track; with ripple all, every later item on every track moves by the length freed, which requires the deleted items to cover one contiguous range.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `item_ids` | array of `string` | yes | at least 1 items; at most 200 items |
| `ripple` | `none`, `track`, `all` | no | none (default), track or all. |

## 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": "item.delete",
  "args": {
    "item_ids": [
      "itm_a1b2c3d4e5"
    ],
    "ripple": "track"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_INVALID_STATE`](/docs/reference/error-codes#e_invalid_state), [`E_OVERLAP`](/docs/reference/error-codes#e_overlap)

## Scope and phase

Scope `edit`, phase `prototype`. Run `vukem-video command:help item.delete` for the same description from the binary.
