---
description: Trim Cloudflare Stream videos by setting start and end times to create new clips via the API.
title: Clip videos
image: https://developers.cloudflare.com/og-docs.png
---

[Skip to content](#main-content)

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/stream/llms.txt  
> Use this file to discover all available pages before exploring further.

# Clip videos

Last updated Aug 24, 2026|Copy as Markdown|[View as Markdown](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/stream/edit-videos/video-clipping/index.md)|[Agent setup](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/agent-setup/)

With video clipping, also referred to as "trimming" or changing the length of the video, you can change the start and end points of a video so viewers only see a specific "clip" of the video. For example, if you have a 20 minute video but only want to share a five minute clip from the middle of the video, you can clip the video to remove the content before and after the five minute clip.

Refer to the [Video clipping API documentation](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/api/resources/stream/subresources/clip/methods/create/) for more information.

Note:

Clipping works differently for live streams and recordings. For more information, refer to [Live instant clipping](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/stream/stream-live/live-instant-clipping/).

## Prerequisites

Before you can clip a video, you will need an API token. For more information on creating an API token, refer to [Creating API tokens](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/fundamentals/api/get-started/create-token/).

## Required parameters

To clip your video, determine the start and end times you want to use from the existing video to create the new video. Use the `videoUID` and the start end times to make your request.

Note

Clipped videos will not inherit the `scheduledDeletion` date. To set the deletion date, you must clip the video first and then set the deletion date.

```json
{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 20,
	"endTimeSeconds": 40
}
```

* **`clippedFromVideoUID`**: The unique identifier for the video used to create the new, clipped video.
* **`startTimeSeconds`**: The timestamp from the existing video that indicates when the new video begins.
* **`endTimeSeconds`**: The timestamp from the existing video that indicates when the new video ends.

```bash
curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts/<YOUR_ACCOUNT_ID_HERE>/stream/clip' \
--header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15
    }'
```

You can check whether your video is ready to play on the **Stream** page of the Cloudflare dashboard.

[Go to **Videos** ↗](https://dash.cloudflare.com/?to=/:account/stream/videos) 

While the clipped video processes, the video status response displays **Queued**. When the clipping process is complete, the video status changes to **Ready** and displays the new name of the clipped video and the new duration.

To receive a notification when your video is done processing and ready to play, you can [subscribe to webhook notifications](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/stream/manage-video-library/using-webhooks/).

## Set video name

When you clip a video, you can also specify a new name for the clipped video. In the example below, the `name` field indicates the new name to use for the clipped video.

```json
{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"meta": {
		"name": "overriding-filename-clip.mp4"
	}
}
```

When the video has been clipped and processed, your newly named video displays in your Cloudflare dashboard in the list videos.

## Add a watermark

You can also add a custom watermark to your video. For more information on watermarks and uploading a watermark profile, refer to [Apply watermarks](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/stream/edit-videos/applying-watermarks).

```json
{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"watermark": {
		"uid": "4babd675387c3d927f58c41c761978fe"
	},
	"meta": {
		"name": "overriding-filename-clip.mp4"
	}
}
```

## Require signed URLs

When clipping a video, you can make a video private and accessible only to certain users by [requiring a signed URL](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/stream/viewing-videos/securing-your-stream/).

```json
{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"requireSignedURLs": true,
	"meta": {
		"name": "signed-urls-demo.mp4"
	}
}
```

After the video clipping is complete, you can open the Cloudflare dashboard and video list to locate your video. When you select the video, the **Settings** tab displays a checkmark next to **Require Signed URLs**.

## Specify a thumbnail image

You can also specify a thumbnail image for your video using a percentage value. To convert the thumbnail's timestamp from seconds to a percentage, divide the timestamp you want to use by the total duration of the video. For more information about thumbnails, refer to [Display thumbnails](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/stream/viewing-videos/displaying-thumbnails).

```json
{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"thumbnailTimestampPct": 0.5,
	"meta": {
		"name": "thumbnail_percentage.mp4"
	}
}
```

Was this helpful?

YesNo

## On this page

[![](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://docs-durable-objects-instance-replaced-errors.previews.developers.cloudflare.com/)

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/stream/edit-videos/video-clipping/#page","headline":"Clip videos · Cloudflare Stream docs","description":"Trim Cloudflare Stream videos by setting start and end times to create new clips via the API.","url":"https://developers.cloudflare.com/stream/edit-videos/video-clipping/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-24","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```