Operations related to live streams. A live stream is a single, linear video broadcast. You broadcast a live stream by receiving encoded source video into the Wowza Video service and letting Wowza Video transcode the stream and deliver it to viewers. A live stream is essentially a one-stop method for creating a transcoder, output renditions, stream targets, and associated players.
Wowza Video
/- Reference
- REST API
- Regenerate the connection code for any stream target
Wowza CDN on Fastly Stream Targets
Custom Stream Targets
Wowza CDN on Akamai Stream targets
Fetch all stream targets
Create a custom stream target
Fetch all custom stream targets
Fetch a custom stream target
Update a custom stream target
Delete a custom stream target
Create a Wowza CDN on Fastly stream target
Fetch all Wowza CDN on Fastly stream targets
Fetch a Wowza CDN on Fastly stream target
Update a Wowza CDN on Fastly stream target
Delete a Wowza CDN on Fastly stream target
Fetch all VOD streams for a Fastly stream target
Configure a property for a stream target
Fetch all properties of a stream target
Fetch a property of a stream target
Delete a stream target property
Regenerate the connection...
Wowza Video REST API Reference Documentation (v1.11)
API lifecycle phase: Supported 2
| Want to take the API for a test run? All you'll need is a Wowza Video subscription, or free trial, for the API access token. Then, fork our collection in Postman and you'll be making calls to our REST API in minutes! See Trial the Wowza Video REST API using Postman for more information. |
This reference documentation provides details about the operations, parameters, and request and reponse schemas for every resource and endpoint in the Wowza Video REST API. Samples appear in the right column. Sample requests are presented in cURL (Shell) and JavaScript; some samples also include just the JSON object. Response samples are all JSON. Examples in cURL use environment variables so you can easily copy and paste them. To learn more, see Using cURL.
Reference documentation is available for every version of the API. Use the Version menu at the top of the page to access the reference doc for a different version of the API.
Download OpenAPI description
Overview
License
Languages
Servers
Mock server
https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi
https://api.video.wowza.com/api/v1.11
- Mock serverhttps://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/stream_targets/fastly/{id}/vod_streams
- https://api.video.wowza.com/api/v1.11/stream_targets/fastly/{id}/vod_streams
- curl
- Java
- Python
- JavaScript
curl -i -X GET \
'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/stream_targets/fastly/{id}/vod_streams'Success
Example: [{"id":"wdjfqvsv","name":"My VOD Stream 1","state":"failed","playback_enabled":false,"created_at":"2020-02-25T17:16:25.849Z","updated_at":"2020-01-28T16:06:47.849Z"},{"id":"XyxZKqHO","name":"My VOD Stream 2","state":"completed","playback_enabled":true,"created_at":"2020-01-29T17:16:21.849Z","updated_at":"2020-01-31T02:26:05.849Z"},{"id":"Pz21DRSt","name":"My VOD Stream 3","state":"completed","playback_enabled":true,"created_at":"2020-01-29T17:16:21.849Z","updated_at":"2020-01-30T18:13:18.849Z"}]
The state of the VOD stream.
Enum"processing""completed""failed"
Example: ""
Specifies whether playback is enabled for the VOD stream.
Enumtruefalse
Example: ""
The reason that a VOD stream has the state of failed. Only returned when the state is failed.
Example: ""
Response
application/json
{ "vod_streams": [ { … }, { … }, { … } ] }
- Mock serverhttps://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/stream_targets/{id}/regenerate_connection_code
- https://api.video.wowza.com/api/v1.11/stream_targets/{id}/regenerate_connection_code
- curl
- Java
- Python
- JavaScript
curl -i -X PUT \
'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/stream_targets/{id}/regenerate_connection_code'Response
application/json
{ "stream_target": { "connection_code": "0cd2e8" } }
Request
This operation configures a property for a stream target. The properties available will depend on the provider you are using and are noted in the key descriptions below. For example, if you are using the provider Wowza CDN on Fastly, look for that in the descriptions.
For a comprehensive resource describing the use of advanced properties, see Set advanced properties with the Wowza Video REST API.
Provide the details of the property or properties to configure in the body of the request. You must include either property or properties in the request as the root object.
One of:
A stream target property. The property configuration consists of a key/value pair and the section of the stream target configuration table the key/value pair is stored in.
Example: {"key":"chunkSize","section":"hls","value":6}
The key of the property.
The following table lists the available property keys.
| Key | Description |
|---|---|
| acao | Explicitly specifies the origin that can access the stream. While most streams won't need the origin explicitly set, you might use this property for older players that don't send the Referer header in their stream request. Available on these targets types: Wowza CDN on Fastly |
| chunkSize | Defines the duration of the time-based audio and video chunks that Wowza Video delivers to the target. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
| convertAMFData | Determines whether Wowza Video converts incoming AMF data into ID3 tags. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
| playlistSeconds | Defines the maximum allowable length of the playlist. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
| playSSL | Determines whether Wowza Video sends the stream from the target to the player by using SSL (HTTPS). Available on these targets types: Custom: akamai_cupertino |
| sendSSL | Determines whether Wowza Video sends the stream from the transcoder to the target by using SSL (HTTPS). Available on these targets types: Custom: akamai_cupertino |
| redundantChunklists | Determines whether Wowza Video creates redundant chunklists within a playlist. If a primary chunklist within a playlist fails, players that support redundancy during playback can switch to the redundant chunklist. Note: Enabling redundantChunklists increases playback reliability but doubles egress data usage and associated charges. Available on these targets types: Custom: akamai_cupertino |
| relativePlaylists | Allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
Enum"acao""chunkSize""convertAMFData""sendSSL""playSSL""playlistSeconds""redundantChunklists""relativePlaylists"
Example: "chunkSize"
The section of the stream target configuration table that contains the property.
| Section | Valid keys for the section |
|---|---|
| hls | acao, chunkSize, convertAMFData, and sendSSL |
| playlist | playSSL, playlistSeconds, redundantChunklists, and relativePlaylists |
Enum"hls""playlist"
Example: "hls"
The value of the property.
The following table provides information about valid values for each property key.
| Key(s) | Values for the key |
|---|---|
| acao | Displays as http://<origin> |
| chunkSize | Valid values are the integers 2, 4, 6, 8, and 10. |
| convertAMFData playSSL sendSSL redundantChunklists relativePlaylists | Valid values are the Booleans true and false. |
| playlistSeconds | Valid values are any integer between 6 and 28800 (8 hours). |
Example: 6
- Mock serverhttps://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/stream_targets/{stream_target_id}/properties
- https://api.video.wowza.com/api/v1.11/stream_targets/{stream_target_id}/properties
- curl
- Java
- Python
- JavaScript
- property
- properties
curl -i -X POST \
'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/stream_targets/{stream_target_id}/properties' \
-H 'Content-Type: application/json' \
-d '{
"property": {
"key": "chunkSize",
"section": "hls",
"value": 6
}
}'Success
One of:
A stream target property. The property configuration consists of a key/value pair and the section of the stream target configuration table the key/value pair is stored in.
Example: {"key":"chunkSize","section":"hls","value":6}
The key of the property.
The following table lists the available property keys.
| Key | Description |
|---|---|
| acao | Explicitly specifies the origin that can access the stream. While most streams won't need the origin explicitly set, you might use this property for older players that don't send the Referer header in their stream request. Available on these targets types: Wowza CDN on Fastly |
| chunkSize | Defines the duration of the time-based audio and video chunks that Wowza Video delivers to the target. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
| convertAMFData | Determines whether Wowza Video converts incoming AMF data into ID3 tags. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
| playlistSeconds | Defines the maximum allowable length of the playlist. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
| playSSL | Determines whether Wowza Video sends the stream from the target to the player by using SSL (HTTPS). Available on these targets types: Custom: akamai_cupertino |
| sendSSL | Determines whether Wowza Video sends the stream from the transcoder to the target by using SSL (HTTPS). Available on these targets types: Custom: akamai_cupertino |
| redundantChunklists | Determines whether Wowza Video creates redundant chunklists within a playlist. If a primary chunklist within a playlist fails, players that support redundancy during playback can switch to the redundant chunklist. Note: Enabling redundantChunklists increases playback reliability but doubles egress data usage and associated charges. Available on these targets types: Custom: akamai_cupertino |
| relativePlaylists | Allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. Available on these targets types: Wowza CDN on Fastly, Custom: akamai_cupertino |
Enum"acao""chunkSize""convertAMFData""sendSSL""playSSL""playlistSeconds""redundantChunklists""relativePlaylists"
Example: "chunkSize"
The section of the stream target configuration table that contains the property.
| Section | Valid keys for the section |
|---|---|
| hls | acao, chunkSize, convertAMFData, and sendSSL |
| playlist | playSSL, playlistSeconds, redundantChunklists, and relativePlaylists |
Enum"hls""playlist"
Example: "hls"
The value of the property.
The following table provides information about valid values for each property key.
| Key(s) | Values for the key |
|---|---|
| acao | Displays as http://<origin> |
| chunkSize | Valid values are the integers 2, 4, 6, 8, and 10. |
| convertAMFData playSSL sendSSL redundantChunklists relativePlaylists | Valid values are the Booleans true and false. |
| playlistSeconds | Valid values are any integer between 6 and 28800 (8 hours). |
Example: 6
Response
application/json
- property
- properties
{ "property": { "key": "chunkSize", "section": "hls", "value": 6 } }
Operations related to recordings, which are created through the /live_streams or /transcoders resources. The Wowza Video service can create MP4 recordings of your live streams and transcoded output. Recordings can be downloaded and saved locally. They're based on the highest-bitrate output rendition that Wowza Video generates from your video source. See About recordings to learn more.
Operations
Operations related to schedules. Schedules allow you to automatically start or stop a live stream or transcoder at a predetermined date and time. You can configure a schedule to start and/or stop a live stream or transcoder just once, or you can configure it to repeat the behavior on a regular basis. See About schedules to learn more.
Operations
Operations related to video on demand (VOD) streams, which are created through the /live_streams or /transcoders resources. A VOD stream is a recording of a live stream that viewers can replay at a later date. After the broadcast is over and the live stream or transcoder is stopped, Wowza Video creates the VOD stream and generates a playback URL. See About VOD Streams to learn more.
Operations
Operations related to Real-Time Streaming at Scale. If your audience is fewer than 300 viewers or you want to deliver a stream in near real time alongside other delivery protocols, use our WebRTC solution.
To enable and purchase capacity for Real-Time Streaming at Scale for your account and access the /real_time operations, contact 720.279.8163 or schedule a call.
Operations