Introduction
The scheduler creates a jobstartstop workflow with tasks that call the Live API to start and stop your channel at the times you specify. You can also configure pre-start and pre-stop webhook notifications.
For Control Room instructions, see Scheduling NextGen Live Events.
Create a start/stop schedule
POST https://api.live.brightcove.com/v2/accounts/{account_id}/jobs/{job_id}/scheduler/jobstartstop{
"job_id": "6386637563112",
"notification_url": "https://your-notification-endpoint.com/webhook",
"description": "Tuesday broadcast",
"metadata_passthrough": {
"event_id": "broadcast-42"
},
"start_action": {
"time_utc": 1742230896,
"notification": 300
},
"stop_action": {
"time_utc": 1742234496,
"notification": 300
}
}| Field | Required | Description |
|---|---|---|
job_id |
Yes | Live channel (job) ID |
notification_url |
Conditional | Webhook URL. Required when notification is set on an action |
start_action.time_utc |
Yes | Unix timestamp (seconds, UTC) when the channel should start |
start_action.notification |
No | Seconds before start to send a pre-start notification |
stop_action.time_utc |
Yes | Unix timestamp (seconds, UTC) when the channel should stop |
stop_action.notification |
No | Seconds before stop to send a pre-stop notification |
List schedules
GET https://api.live.brightcove.com/v2/accounts/{account_id}/jobs/{job_id}/scheduler?state=pendingQuery parameters: state (comma-separated), start, end, page_size (max 100), start_token.
Update a schedule
PATCH https://api.live.brightcove.com/v2/accounts/{account_id}/jobs/{job_id}/scheduler/jobstartstop/{workflow_id}You can update actions that are still in pending state. Stop time must be after start time.
Delete a schedule
DELETE https://api.live.brightcove.com/v2/accounts/{account_id}/jobs/{job_id}/scheduler/jobstartstop/{workflow_id}Pending tasks are cancelled. Records remain visible for 30 days. The channel stays in its current state.