Cut.ProDocs
Clips

List generated clips

Returns the AI-generated highlight clips produced by a completed submission. Each clip includes its timestamp range within the source video, an AI relevance score, and signed URLs for streaming and downloading.

Sort by rating (default) to surface the most impactful clips first. Download and play URLs are time-limited signed URLs — fetch them fresh when needed rather than caching them long-term.

Returns 410 if the submission has expired. Re-submit the video to generate new clips.

Authorization

apiKey
X-Api-Key<token>

In: header

Path Parameters

videoId*string
submissionId*string

Query Parameters

page?number

Page number (default: 1)

Range1 <= value
limit?number

Items per page (default: 20, max: 100)

Range1 <= value <= 100
sort?string

Value in

  • "rating"
  • "duration"
  • "title"
  • "start_time"
order?string

Value in

  • "asc"
  • "desc"
min_rating?number

Only return clips with rating ≥ this value (0–10)

Range0 <= value <= 10
max_rating?number

Only return clips with rating ≤ this value (0–10)

Range0 <= value <= 10

Response Body

application/json

application/json

application/json

GET
/clips/{videoId}/submissions/{submissionId}/clips
curl -X GET "https://example.com/clips/string/submissions/string/clips"
{  "clips": [    {      "id": "string",      "title": "string",      "description": "string",      "rating": 0,      "start_time": 0,      "end_time": 0,      "language": "string",      "created_at": "string",      "thumbnail_url": "string",      "download_url": "string",      "play_url": "string",      "has_template_applied": true    }  ],  "pagination": {    "current_page": 0,    "total_pages": 0,    "total_count": 0,    "has_next_page": true,    "has_previous_page": true,    "limit": 0  }}

Apply template to clips POST

Asynchronously applies one of your saved templates to all (or a subset of) the generated clips in a submission. The job runs in the background — returns immediately with the number of clips being processed. Once a template is applied, each clip gets its own edit settings that you can then render via `POST /clips/{videoId}/submissions/{submissionId}/clips/{clipId}/render`. Only one batch job can run at a time per account. Returns `429` if another is already running.

Delete a clip DELETE

Permanently deletes a single generated clip. This action cannot be undone.