Add several events to a schedule channel
This endpoint places up to 500 events on a Cloud Playout schedule channel in one request, so a block of programming from a few minutes to a full day can be scheduled in a single call rather than one event at a time.
The request is all or nothing: if any event cannot be placed, none of them are written. Validation runs in stages, and each stage reports every offending entry by its position in the array as events[0], events[1] and so on, but a later stage only runs once the earlier one passes, so a batch may need more than one round to get through:
-
Field and shape errors (422
Request validation failed): missing or malformed fields, type-conditional rules such as avodwithoutreferenceIdor alivewithoutendTime, astartTimein the past, or a batch that spans more than 24 hours. -
Media problems (400
Invalid media): avodentry whose media does not exist, is notready, or has no duration. -
Schedule conflicts (409
Schedule conflict): an entry outside the channel’s start and end times, inside the on-air restriction window, overlapping another entry in the batch, or overlapping an event already on the timeline.
How it works
-
Make a POST request to this endpoint with an
eventsarray. Each entry has atypeand astartTime. -
What else an entry carries depends on its
type:vodplays one media item. Send itsreferenceIdand leaveendTimeandnameout; the event ends when the media does.livereserves a slot for the channel’s live input. SendendTimeand aname, and leavereferenceIdout. The slot must be at least 5 minutes long.
-
The response returns the events that were created, in the order they play.
All of the events must fall within a single 24 hour window, measured from the earliest start to the latest end, and every one must sit inside the channel’s own start and end times. Events may not overlap one another or anything already scheduled on the channel; an event may start exactly when the previous one ends. Media used by a vod event must have reached the ready status. On a channel that is on air, no event may start or end in the next few minutes.
Gaps between events are allowed. The channel shows its slate for any time nothing is scheduled.
Example
A news channel loads tomorrow’s line-up in one request: an overnight loop of recorded bulletins as vod events, a two hour live slot for the morning show, and the afternoon programming, all placed at their exact times.
Authentication
FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.
- Username: Access Token ID
- Password: Secret Key
Activate your FastPix account to generate your API credentials. See the guide here