Update an event on a schedule channel
This endpoint moves or renames an event on a Cloud Playout schedule channel, and is also how you attach a bumper to it. The id in the path is the event’s ID, not the channel’s.
How it works
-
Make a PATCH request to this endpoint with the ID of the event you want to change.
-
Send both
startTimeandendTime. Both are required, even if only one of them changes, andstartTimemust be in the future. For avodevent the span between them must equal the media’s duration to the whole second, so to move avodevent shift both times by the same amount; any other span is refused with 400Duration mismatch. Fractional seconds (yyyy-MM-dd'T'HH:mm:ss.SSS) are accepted and stored as sent. -
For a
liveevent, send itsnameon every update: the stored name is not carried over, and an update without one is rejected with 400Invalid name. For avodevent leavenameout, as its name comes from the media. On avodevent you can also send abumperwith apreroll, apostroll, or both. Each bumper needs itsidand itsduration, and the duration must match the bumper’s own length. -
The response returns the updated event.
The type of an event cannot be changed, and neither can what it plays, so leave type out and either leave referenceId out (the stored value is used) or send the one the event already has. A live event must still be at least 5 minutes long. Bumpers can only be attached to vod events; a bumper sent for a live event is rejected. Sending a bumper with no preroll and no postroll clears the ones already attached, and bumpers cannot be attached to an event that has segments on it. On a channel that is on air, an event cannot be changed if it runs, or would run, in the next few minutes.
Example
A broadcaster pushes an evening film back by fifteen minutes and adds a five second sting in front of it.
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
Path parameters
The unique identifier of the event to update, as returned in the id field by the get the events on a schedule channel endpoint.