Update a monitor
Changes only the fields sent; null clears template_id and the duration limits. enabled follows the same rules as start and stop. Refusals: 400 INVALID_DURATION_RANGE, 402, 403, 404, 409 MINIMUM_MONITORING_TIME.
apiKeyX-Api-Key<token>id*stringMonitor id, from GET /monitors
^[0-9]{1,19}$- body
enabled?booleanstrategy_id?stringID of a clipping strategy. On create, omit to use the default AI settings
^[0-9]{1,19}$template_id?||ID of an edit template from GET /templates; null = none
^[0-9]{1,19}$video_min_duration?|1 <= value <= 3600video_max_duration?|1 <= value <= 3600days_of_week?array<|>hours_of_day?array<array<|>>Response for status 200
application/json- response
id*stringMonitor id, used in every /monitors/{id} route
platform*string"youtube""twitch""kick"username*stringChannel handle on the platform
display_name*||Channel name as shown on the platform
avatar_url*string|null|nullenabled*booleantrue while the monitor is on. It can also turn itself off when the balance runs out
enabled_at*||ISO 8601 timestamp of when the current monitoring period started; null while off. Stopping is refused for the first 10 minutes after it.
strategy_id*stringClipping strategy applied to every clip
template_id*||Edit template applied to every clip; null = none
type*"live""live"on_air*booleantrue while the channel is broadcasting
broadcasts_count*numberBroadcasts recorded since the channel was first monitored
clips_count*numberClips this workspace got from the channel's broadcasts whose recording is still kept
last_broadcast_at*||ISO 8601 timestamp of when the latest broadcast started
thumbnail_url*||Cover of the latest broadcast. Signed URL, time-limited
next_batch*||Progress of the next batch; null unless the broadcast is on air and the monitor is on
batch_credits*numberCredits the next 10-minute batch of this channel costs your workspace, after any discount
curl -X PATCH 'https://api.cut.pro/api/v1/monitors/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "platform": "youtube", "username": "string", "display_name": null, "avatar_url": null, "enabled": true, "enabled_at": null, "strategy_id": "string", "template_id": null, "type": "live", "on_air": true, "broadcasts_count": 0, "clips_count": 0, "last_broadcast_at": null, "thumbnail_url": null, "next_batch": null, "batch_credits": 0}Get a monitored channel GET
Returns one monitored channel and whether it is on. Monitoring can also turn itself off when the balance runs out.
Stop watching a channel DELETE
Removes the monitor and turns it off. Clips it already produced stay in the workspace, and creating a monitor for the same channel and `type` again brings this one back with its history and automations, under the same `id`.