Skip to Content
Cut.ProDocs
Live clipping: monitored channels

Apply template to broadcast clips

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.

Authorization

apiKey
headerX-Api-Key<token>

Path Parameters

id*string

Monitor id, from GET /monitors

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

Broadcast id, from GET /monitors/{id}/broadcasts

Request Body

  1. body
template_id*string

ID of a template from GET /templates

Match^[0-9]{1,19}$
clip_ids?array<string>

Subset of clip IDs. Omit to apply to every clip of the broadcast

Response Body

Response for status 200

application/json
  1. response
clips_count*number

0: no clips matched

POST
/monitors/{id}/broadcasts/{broadcastId}/clips/apply_template
Example Request
curl -X POST 'https://api.cut.pro/api/v1/monitors/string/broadcasts/string/clips/apply_template' \  -H 'Content-Type: application/json' \  -d '{  "template_id": "string"}'
Example Response
{  "clips_count": 0}