Cut.ProDocs
Monitoring

List broadcasts of a live monitor

Returns the channel's broadcasts, newest first, each with how many clips this workspace got from it. A broadcast with ended_at: null is on air and keeps producing clips every 10 minutes while the monitor is on. Only live monitors have broadcasts: a video monitor answers 400 INVALID_OBSERVING_TYPE, and its clips arrive as regular submissions in GET /clips.

Authorization

apiKey
X-Api-Key<token>

In: header

Path Parameters

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

Query Parameters

page?number

Page number (default: 1)

Range1 <= value
limit?number

Items per page (default: 20, max: 100)

Range1 <= value <= 100

Response Body

application/json

application/json

application/json

GET
/monitors/{id}/broadcasts
curl -X GET "https://example.com/monitors/string/broadcasts"
{  "broadcasts": [    {      "id": "string",      "title": "string",      "category": "string",      "language": "string",      "is_mature": true,      "tags": [        "string"      ],      "started_at": "string",      "ended_at": "string",      "clips_count": 0,      "thumbnail_url": "string",      "recording_expired": true    }  ],  "pagination": {    "current_page": 0,    "total_pages": 0,    "total_count": 0,    "has_next_page": true,    "has_previous_page": true,    "limit": 0  }}

Stop monitoring POST

Turns monitoring off. No new batch is clipped or charged after this, and a recording in progress stops within about a minute. Monitoring must stay on for at least 10 minutes before it can be stopped: earlier you get `409` with `extra.remaining_seconds`. Calling it on a monitor that is already off changes nothing and answers `200`. Refusals: `404`, `409`.

List clips of a broadcast GET

Returns the clips this workspace got from one broadcast, best rated first by default. While the broadcast is on air, new clips land every 10 minutes, so poll this list rather than waiting for the broadcast to end. A clip with an `edit_id` is ready to render or post; one without it renders with the default layout through `POST /monitors/{id}/broadcasts/{broadcastId}/clips/{clipId}/render`. Returns `410` once the recording was purged.