> 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/clip_command.md). # Clip command KickBot API and MCP reference for Clip command. Settings for the !clip chat command. Settings for the !clip chat command. MCP area name: `clip_command`. | Tool | REST | Access | | --------------------------------------------------------------- | -------------------------------------- | ------ | | [`get_clip_command_settings`](#get-clip-command-settings) | `GET /clip-command/settings` | Read | | [`update_clip_command_settings`](#update-clip-command-settings) | `PATCH /clip-command/settings` | Write | | [`list_command_clips`](#list-command-clips) | `GET /clip-command/clips` | Read | | [`delete_command_clip`](#delete-command-clip) | `DELETE /clip-command/clips/{clip_id}` | Write | ## get\_clip\_command\_settings **Get the !clip command settings.** Read the settings of the !clip chat command: on/off, who can use it, the reply text, and the clip lengths. premium\_settings\_editable tells you if custom\_response and the clip lengths can be changed (premium plan). `GET /api/v1/clip-command/settings` No input fields. ## update\_clip\_command\_settings **Update the !clip command settings.** Change some !clip command settings. Only the fields you send change. Requires a verified account. custom\_response, max\_clip\_length, and default\_clip\_length are premium settings: a free account that sends a different value gets a premium\_required error and nothing is saved. `PATCH /api/v1/clip-command/settings` Needs a read and write key or connection. | Field | Type | Required | Description | | --------------------- | ---------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `enabled` | boolean | No | Turn the !clip command on or off. | | `everyone_only` | boolean | No | Everyone in chat can use it. | | `subscriber_only` | boolean | No | Subscribers can use it (when everyone\_only is false). | | `vip_only` | boolean | No | VIPs can use it (when everyone\_only is false). | | `mod_only` | boolean | No | Moderators can use it (when everyone\_only is false). | | `custom_response` | string or string | No | Premium only. The chat reply after a clip is made, 15-300 characters. Variables: {user} (who clipped) and {clip\_url}. Default "@{user} {clip\_url}". Empty resets to the default. | | `max_clip_length` | integer | No | Premium only. Longest clip in seconds a viewer can ask for (for example !clip 90), 10-240. Default 120. | | `default_clip_length` | integer | No | Premium only. Clip length in seconds when the viewer gives no length, 10-120. Default 30. | ## list\_command\_clips **List clips made with !clip.** List the finished clips viewers made with the !clip command (up to 5 minutes long). Each clip has a public page (url). total\_clips counts all finished clips. `GET /api/v1/clip-command/clips` | Field | Type | Required | Description | | -------------------------- | ------------------------------------------------------------- | -------- | -------------------------------------------------------------- | | `sort` (query) | `"newest"` or `"oldest"` or `"most_views"` or `"least_views"` | No | Order: newest (default), oldest, most\_views, or least\_views. | | `clipper_username` (query) | string | No | Only clips made by this Kick username (not case-sensitive). | | `limit` (query) | integer | No | Max clips to return (1-100, default 50). | | `offset` (query) | integer | No | Number of clips to skip (default 0). | ## delete\_command\_clip **Delete a !clip clip.** Delete a clip made with !clip: its video files and its public page. Needs the manage\_clips permission. This cannot be undone. `DELETE /api/v1/clip-command/clips/{clip_id}` Needs a read and write key or connection. This cannot be undone. | Field | Type | Required | Description | | ----------------------- | ------ | -------- | --------------------------------------------------------------------- | | `clip_id` (in the path) | string | Yes | The clip id, the last part of . | ## Need help? Email 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/clip_command.md?ask=&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.