List monitored channels
Returns the channels this workspace monitors, newest first, with whether each one is on, the settings its clips use and, for a live monitor, whether the channel is on air, its counts and what its next batch costs.
apiKeyX-Api-Key<token>page?numberPage number (default: 1)
1 <= valuelimit?numberItems per page (default: 50, max: 100)
1 <= value <= 100type?string"live""video"Response for status 200
application/json- response
monitors*array<|>pagination*curl -X GET 'https://api.cut.pro/api/v1/monitors'{ "monitors": [ { "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 } ], "pagination": { "current_page": 0, "total_pages": 0, "total_count": 0, "has_next_page": true, "has_previous_page": true, "limit": 0 }}Render a clip POST
Queues a clip for video rendering. Returns the 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.
Monitor a channel POST
Starts watching a YouTube, Twitch or Kick channel, from its URL in `channel` or from a `creator_id` that `GET /monitors/search` or `GET /monitors/discover` returned. A `live` monitor clips each broadcast while it airs, charged per 10-minute batch; a `video` monitor clips each new upload. It is born on unless `enabled` is `false`, which is how a 24/7 stream is set up once and then switched with `start` and `stop`. Refusals: `400` (`CHANNEL_REQUIRED` when neither `channel` nor `creator_id` is sent), `402`, `403`, `404`, `409 ALREADY_MONITORING`, and `429` (10 per minute, because it looks the channel up on the platform).