> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kernelmedia.tv/llms.txt
> Use this file to discover all available pages before exploring further.

# Recordings & Markers

> Recordings, commercial cutting, and intro/credits detection

All endpoints need an [admin token](https://docs.kernelmedia.tv/api-reference/admin/overview.md#authentication).

## Recordings

| Method | Path | Description |
| - | - | - |
| `GET` | `/api/admin/recordings` | Every recording on the server, with its channel name |
| `POST` | `/api/admin/recordings/{id}/rerun` | Retry the conversion of a failed recording |

## Commercial cutting <sup>New in 0.9.0</sup>

When a recording finishes, Kernel runs [Comskip](https://github.com/erikkaashoek/Comskip) on it to find the ad breaks, then rewrites the file without them. Without Comskip installed on the server, recordings are kept uncut.

| Method | Path | Description |
| - | - | - |
| `POST` | `/api/admin/recordings/{id}/commercials` | Run commercial cutting again on a finished recording |
| `GET` | `/api/admin/recordings/{id}/commercials` | Latest progress for that recording |

The run happens in the background (Comskip takes minutes on a long recording). Progress is also pushed over the WebSocket as `commercial_removal_progress` messages:

```json theme={null}
{"recording_id": "<id>", "status": "scanning", "progress": 42, "message": "Scanning for commercials: 60%"}
```

`status` moves through `scanning` → `cutting` → `completed`, or ends at `failed`, in which case the recording is kept uncut.

`GET` returns the same payload, so a page opened mid-run can pick up where it is. It returns `404` if there has been no run since the server started.

## Intro and credits detection <sup>New in 0.9.0</sup>

Skip Intro and Skip Credits markers come from a background pass over your TV episodes and movies. Files that can't be fingerprinted or probed are retried on the next pass.

| Method | Path | Description |
| - | - | - |
| `GET` | `/api/admin/markers/failures` | Files that failed detection: `{"count": N, "failures": [...]}` |
| `POST` | `/api/admin/markers/failures/reset` | Clear the failures so those files are scanned again. Add `?item_id=` to reset one item. |

To start a detection pass yourself, create a `detect_markers` [task](https://docs.kernelmedia.tv/api-reference/admin/server.md#tasks).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.