Cut.ProDocs
Live clipping: monitored channels

Render a broadcast clip

Queues a live clip for rendering and returns the render id to poll with GET /renders/{renderId}. The clip renders with its template when one was applied, otherwise with the default layout. If an identical render is already in storage, returns 200 with from_cache: true and a ready download_url; 409 if the same clip is already rendering.

Authorization

apiKey
X-Api-Key<token>

In: header

Path Parameters

id*string
Match^[0-9]{1,19}$
broadcastId*string
clipId*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

POST
/monitors/{id}/broadcasts/{broadcastId}/clips/{clipId}/render
curl -X POST "https://example.com/monitors/string/broadcasts/string/clips/string/render"
{  "id": "string",  "edit_id": "string",  "status": "completed",  "has_watermark": true,  "output_resolution": "string",  "from_cache": true,  "download_url": "string"}

Apply template to broadcast clips POST

Applies one of your templates to every clip of a broadcast, or to the `clip_ids` given, in the background. Each clip's `edit_id` shows up in `GET /monitors/{id}/broadcasts/{broadcastId}/clips` as it is done. To template every future clip instead, set `template_id` on the monitor. Only one batch runs at a time per account: another one answers `429`.

List templates GET

Returns a paginated list of video editing templates. Use `filter=mine` (default) to list your own templates, or `filter=public` for CutPro's built-in public templates. Pass a template's `id` to `POST /clips/{videoId}/submissions/{submissionId}/apply_template` to apply it in bulk to your generated clips.