# timeline.close_gap

> Closes the empty range that contains a given frame on a track.

Source: https://alexgalhardo.github.io/vukem-video/docs/reference/commands/timeline.close_gap/

Moves the items after the gap earlier by the length of the gap: those of the track (ripple track, the default) or those of every track (ripple all).

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `at` | `string` | yes | Absolute frame inside the gap. |
| `ripple` | `track`, `all` | no | track (default) or all: all moves later items of every track. |
| `track_id` | `string` | yes | The track with the gap. |

## 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": "timeline.close_gap",
  "args": {
    "at": "70f",
    "track_id": "trk_f6g7h8j9k0"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_INVALID_TIME`](/docs/reference/error-codes#e_invalid_time), [`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 `alpha`. Run `vukem-video command:help timeline.close_gap` for the same description from the binary.
