Cut.ProDocs
Clips

Delete a clip

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

Authorization

apiKey
X-Api-Key<token>

In: header

Path Parameters

videoId*string
submissionId*string
clipId*string

Response Body

application/json

application/json

DELETE
/clips/{videoId}/submissions/{submissionId}/clips/{clipId}
curl -X DELETE "https://example.com/clips/string/submissions/string/clips/string"
Empty

List generated clips GET

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.

Render a clip POST

Queues a clip for video rendering. Returns a `render_id` you can use to poll status via `GET /renders/{renderId}`. If a template has been applied to the clip (see `apply_template`), the rendered video will include all template customisations (captions, effects, cropping, etc.). Otherwise the clip is rendered with default settings. If an identical render has already been completed, returns `200` with `from_cache: true` and a ready `download_url`. Returns `409` if the same clip is already being rendered.