How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Brightcove Live Jobs API

Operations for creating live jobs, listing live jobs, getting job details, and canceling live jobs. There are also operations for activating and deactivating SEP jobs, scheduling activation and deactivation of SEP jobs, and for inserting cuepoints or ID3 timed metadata.Notes:-Live outputs are VBR.-The average video bitrate should be around the target value, but there can be brief periods when the measured video bitrate exceeds that target.

Brightcove Live Jobs API is one of 53 APIs that Brightcove publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Live Jobs. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 12 operations across 10 paths, and defines 44 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.bcovlive.io/v1.

12 operations 10 paths 44 schemas 1 DELETE2 GET5 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://cms.api.brightcove.com/v1
Resource Areas
1

Paths & Operations 12

Across 10 paths, the API surfaces 12 operations — 1 DELETE, 2 GET, 5 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Live Jobs 12

Operations for creating live jobs, listing live jobs, getting job details, and canceling live jobs. There are also operations for activating and deactivating SEP jobs, scheduling…

POST
/jobs
Create a Live Job
CreateALiveJob 2 params body → 200400401404500
GET
/jobs
List Live Jobs
ListLiveJobs 15 params → 200400401404500
GET
/jobs/{job_id}
Get Live Job Details
GetLiveJobDetails 3 params → 200401404500
POST
/jobs/{job_id}/playback-token
Create Playback Token
CreatePlaybackToken 3 params body → 200401404500
PUT
/jobs/{job_id}/activate
Activate SEP Stream
ActivateSepStream 3 params → 200401404500
PUT
/jobs/{job_id}/deactivate
Deactivate SEP Stream
DeactivateSepStream 3 params → 200401404500
POST
/jobs/{job_id}/cuepoint
Manual Cue Point Insertion
ManualAdCuePointInsertion 3 params body → 200400401404500
POST
/jobs/{job_id}/cuepointdata
Add or update Ad Metadata
AddAdMetadata 3 params body → 200400401404500
DELETE
/jobs/{job_id}/cuepointdata
Delete Ad Metadata
DeleteAdMetadata 3 params → 204400401404500
POST
/jobs/{job_id}/id3tag
Insert ID3 Timed Metadata
InsertId3TimedMetadata 3 params body → 200400401404500
PUT
/jobs/{job_id}/cancel
Cancel Live Job
CancelLiveJob 2 params → 200401404500
PUT
/jobs/{job_id}/stop
Stop Live Job
StopLiveJob 2 params → 200401404500

Schemas 44

The contract defines 44 schemas that model the data the API accepts and returns. The most detailed are CreateLiveJobRequestBody (35 properties), Job.outputMediaFiles (32 properties), CreateLiveJobRequestBody.outputs (29 properties), Job.inputMediaFile (23 properties). Each schema is shown below with its type and property counts.

Job.outputMediaFiles
object
32 properties 19 required
CreateVodClipbody.outputs.videocloud.video.schedule
object
map of scheduling properties
2 properties 2 required
CreateLiveJobRequestBody.addCdns
object
5 properties 3 required
CreateLiveJobRequestBody.addCdns.tokenAuth.media
object
Object containing tokenization properties
3 properties
CancelLiveJob
object
1 property
Id3Tag
object
2 properties 2 required
ManualAdCuePointInsertionbody
object
5 properties 1 required
CreateLiveJobRequestBody.videocloud
object
Video Cloud customers have the option to create a video to use for the live stream. The videocloud object in the job settings is used for this purpose. If you…
5 properties 1 required
CreateLiveJobRequestBody.addCdns.tokenAuth
object
Token authentication details Note: If you don't have your secret key for Akamai, or need to have a new one, contact your Customer Success Manager or Brightcove…
4 properties 3 required
Job.inputMediaFile
object
Object containing properties for the input media file. Note that some fields under the media file object are null. These fields were ported from the old Zencod…
23 properties
CuePoint
object
4 properties 4 required
ManualAdCuePointInsertionResponse
object
2 properties 2 required
CreateVodClipbody.outputs.videocloud.video
object
'An object containing inputs for Video Cloud video object creation - see the [CMS API Reference](https://apis.support.brightcove.com/cms/references/reference.h…
12 properties 1 required
AddAdMetadatabody
object
- A set of key/value pairs for ad requests.
1 property
LiveJob
object
15 properties 14 required
CreateVodClipbody.outputs.videocloud.video.geo
object
map of geo-filtering properties
3 properties 3 required
DeactivateSepStreamResponse
object
1 property 1 required
InsertId3TimedMetadatabody
object
1 property 1 required
CreateLiveJobRequestBody.videocloud.video
object
'An object containing inputs for Video Cloud video object creation - see the [CMS API Reference](https://apis.support.brightcove.com/cms/references/reference.h…
12 properties 1 required
Job.stream.location
object
Object representing the location of the stream
3 properties
CreatePlaybackTokenRequestBody
object
Create Playback Token Request Body
4 properties
ActivateSepStreamResponse
object
1 property 1 required
InsertId3TimedMetadatabody.id3Tag
object
An object containing variables for the ID3 timed metadata
3 properties 2 required
Outputs
object
4 properties 4 required
CreateLiveJob.outputs.videocloud
object
An object containing inputs for Video Cloud ingestion
3 properties 2 required
CreateLiveJobRequestBody
object
35 properties 3 required
CreateLiveJobRequestBody.alternate_tracks
object
Object containing audio track properties
7 properties 4 required
Notification
object
3 properties 2 required
CreateLiveJobRequestBody.videocloud.video.cuePoint
object
5 properties 2 required
CreateLiveJobRequestBody.videocloud.video.geo
object
map of geo-filtering properties
3 properties 3 required
ListLiveJobsResponse
object
3 properties 2 required
PlaybackToken
object
An adconfigid to use for playback
1 property
CreateLiveJobRequestBody.outputs
object
29 properties 4 required
CreateVodClipbody.outputs.videocloud.video.cuePoint
object
5 properties 2 required
Job.stream
object
Object containing properties for the live stream
16 properties
InsertId3TimedMetadataResponse
object
2 properties 2 required
CreateLiveJobRequestBody.videocloud.video.schedule
object
map of scheduling properties
2 properties 2 required
StopLiveJob
object
1 property
CreateVodClipbody.outputs.videocloud.ingest
object
An object containing inputs for Video Cloud video ingestion - see the [Dynamic Ingest Reference](https://apis.support.brightcove.com/dynamic-ingest/references/…
3 properties
playback_added_cdns
object
3 properties 3 required
RTMPout
object
RTMP output object
6 properties
Job.stream.destination
object
Object representing the destination of the stream
3 properties
CreateLiveJobRequestBody.encryption
object
Encryption to apply to the stream.
8 properties 2 required
Job
object
22 properties 9 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

brightcove-live-jobs-api-openapi.yml Raw ↑

Other APIs Brightcove publishes across the network.

Brightcove Dynamic Ingest API
Brightcove Analytics API
Brightcove Playback API
Brightcove Player Management API
Brightcove Live API
Brightcove OAuth API
Brightcove SSAI API
Brightcove Ingest Profiles API
Brightcove Delivery Rules API
Brightcove Cloud Playout APIs
Brightcove Audience API
Brightcove Social API
Where this information came from

This is an independent, third-party profile of Brightcove Live Jobs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.