> For the complete documentation index, see [llms.txt](https://docs.kickbot.com/dashboard/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kickbot.com/dashboard/api/reference/vods.md).

# VODs

KickBot API and MCP reference for VODs. VOD downloads and the VOD clip editor.

VOD downloads and the VOD clip editor. MCP area name: `vods`.

| Tool                                                | REST                          | Access |
| --------------------------------------------------- | ----------------------------- | ------ |
| [`list_vod_downloads`](#list-vod-downloads)         | `GET /vods/downloads`         | Read   |
| [`get_kick_vod`](#get-kick-vod)                     | `GET /vods/kick`              | Read   |
| [`start_vod_download`](#start-vod-download)         | `POST /vods/downloads`        | Write  |
| [`delete_vod_download`](#delete-vod-download)       | `DELETE /vods/downloads/{id}` | Write  |
| [`list_vod_editor_clips`](#list-vod-editor-clips)   | `GET /vods/editor/clips`      | Read   |
| [`create_vod_editor_clip`](#create-vod-editor-clip) | `POST /vods/editor/clips`     | Write  |

## list\_vod\_downloads

**List VOD downloads.** List the VOD downloads of the last 14 days, newest first, with status, queue position, and download\_url when complete. Files expire (expires\_at): 36 hours on the free plan, 14 days on premium. Call it again to check progress.

`GET /api/v1/vods/downloads`

| Field            | Type    | Required | Description                              |
| ---------------- | ------- | -------- | ---------------------------------------- |
| `limit` (query)  | integer | No       | Max items to return (1-100, default 50). |
| `offset` (query) | integer | No       | Number of items to skip (default 0).     |

## get\_kick\_vod

**Look up a Kick VOD.** Look up a Kick VOD (past broadcast) by URL: title, channel, length, and the qualities (resolutions) you can download. Use it before start\_vod\_download or create\_vod\_editor\_clip.

`GET /api/v1/vods/kick`

| Field               | Type   | Required | Description                                                |
| ------------------- | ------ | -------- | ---------------------------------------------------------- |
| `video_url` (query) | string | Yes      | The Kick VOD URL, for example <https://kick.com//videos/>. |

## start\_vod\_download

**Download a Kick VOD.** Start downloading a Kick VOD as a video file. Free plans can start 2 downloads per 24 hours (failed ones do not count); premium downloads use the priority queue. A VOD that is already queued cannot be added again. Check list\_vod\_downloads for progress and the download\_url.

`POST /api/v1/vods/downloads`

Needs a read and write key or connection. This has an effect outside your settings (for example on your live stream). Rate limit: 10 per minute, 100 per day.

| Field        | Type   | Required | Description                                                                                                     |
| ------------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------- |
| `video_url`  | string | Yes      | The Kick VOD URL, for example <https://kick.com//videos/>.                                                      |
| `resolution` | string | No       | A resolution from get\_kick\_vod, for example 1080p60, 720p60, or audio\_only. Default: the best video quality. |

## delete\_vod\_download

**Delete a VOD download.** Delete a finished VOD download: the file is removed and the download link stops working. This cannot be undone. Downloads that are not complete yet cannot be deleted.

`DELETE /api/v1/vods/downloads/{id}`

Needs a read and write key or connection. This cannot be undone.

| Field              | Type    | Required | Description                                |
| ------------------ | ------- | -------- | ------------------------------------------ |
| `id` (in the path) | integer | Yes      | The download id from list\_vod\_downloads. |

## list\_vod\_editor\_clips

**List VOD editor clips.** List the clips cut from Kick VODs with the VOD editor, newest first, with status and download\_url when complete.

`GET /api/v1/vods/editor/clips`

| Field            | Type    | Required | Description                              |
| ---------------- | ------- | -------- | ---------------------------------------- |
| `limit` (query)  | integer | No       | Max items to return (1-100, default 50). |
| `offset` (query) | integer | No       | Number of items to skip (default 0).     |

## create\_vod\_editor\_clip

**Cut a clip from a Kick VOD.** Cut a clip from a Kick VOD in the best quality. Clips can be up to 20 minutes on the free plan and 3 hours on premium. KickBot processes it in the background; check list\_vod\_editor\_clips for the status and download\_url.

`POST /api/v1/vods/editor/clips`

Needs a read and write key or connection. This has an effect outside your settings (for example on your live stream). Rate limit: 10 per minute, 100 per day.

| Field           | Type   | Required | Description                                                                          |
| --------------- | ------ | -------- | ------------------------------------------------------------------------------------ |
| `video_url`     | string | Yes      | The Kick VOD URL, for example <https://kick.com//videos/>.                           |
| `start_seconds` | number | Yes      | Start of the clip, in seconds from the start of the VOD. Decimals are allowed.       |
| `end_seconds`   | number | Yes      | End of the clip, in seconds from the start of the VOD. Must be after start\_seconds. |
| `name`          | string | Yes      | Name of the clip (1-100 characters).                                                 |

## Need help?

Email <support@kickbot.com> or ask in the `#support` channel on [Discord](https://discord.gg/MAg3gBbc89).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.kickbot.com/dashboard/api/reference/vods.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.