Skip to Content
Cut.ProDocs
Clipping: strategies

Update a clipping strategy

Changes only the fields sent, with the same 400 codes as creating one, checked against the result. Submissions already made keep the settings they ran with. 403 STRATEGY_PROTECTED on CutPro's ready-made ones.

Authorization

apiKey
headerX-Api-Key<token>

Path Parameters

id*string

Strategy id, from GET /strategies

Match^[0-9]{1,20}$

Request Body

  1. body
name?string

Unique among your strategies

Length1 <= length <= 32
description?string

For you; the AI does not read it

Lengthlength <= 128
clip_focus?string

What the AI should look for when picking moments, in your own words

Lengthlength <= 512
title_style?string

How the clip titles should be written

Lengthlength <= 512
clip_min_length?number

Shortest clip, in seconds

Range5 <= value <= 3600
clip_max_length?number

Longest clip, in seconds; at least 5 more than clip_min_length

Range10 <= value <= 7200
translate_to?string

Language code (ISO 639-1, e.g. en) the clips' captions are translated into, which costs more per submission. Omit to keep the spoken language

Lengthlength <= 16

Response Body

Response for status 200

application/json
  1. response
id*string

Pass it as strategy_id to POST /videos/{videoId}/submissions or to a monitor

name*string
description*string|null|null
clip_focus*||

What the AI looks for when picking moments

title_style*||

How the clip titles are written

clip_min_length*number

Shortest clip, in seconds

clip_max_length*number

Longest clip, in seconds

translate_to*||

Language the captions are translated into; null keeps the spoken one

is_public*boolean

true for CutPro's ready-made strategies, which cannot be edited or deleted

created_at*string
updated_at*string
PATCH
/strategies/{id}
Example Request
curl -X PATCH 'https://api.cut.pro/api/v1/strategies/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "string",  "name": "string",  "description": null,  "clip_focus": null,  "title_style": null,  "clip_min_length": 0,  "clip_max_length": 0,  "translate_to": null,  "is_public": true,  "created_at": "string",  "updated_at": "string"}