Skip to content
Wowza Video
/
/
/
Configure a property for...

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
openapi.json
openapi.yaml
Overview
License
Terms of Use
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

Live Streams

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.

Operations

Players

Operations related to players, which are created through the /live_streams resource. Players created through Wowza Video live streams can be embedded into your own web page or played through a web page hosted by Wowza Video.

Operations

Transcoders

Operations related to transcoders, output renditions, and output stream targets.

Operations

Restart an output stream target

Request

This operation restarts an output stream target.

Path
transcoder_idstringrequired

The unique alphanumeric string that identifies the transcoder.

output_idstringrequired

The unique alphanumeric string that identifies the output rendition.

stream_target_idstringrequired

The unique alphanumeric string that identifies the stream target.

Tip: If you're using both the primary and backup URL for a stream target, send output_stream_target_id in the path instead. output_stream_target_id was returned when you added the stream target to the ouput rendition. This allows you to differentiate between the primary and backup URL versions of the stream target.

curl -i -X PUT \
  'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/transcoders/{transcoder_id}/outputs/{output_id}/output_stream_targets/{stream_target_id}/restart'

Responses

Success

Bodyapplication/json
stream_targetobject(stream_target)required
stream_target.​statestring

The state of the output stream target.

Enum"enabled""disabled""restarted"
Example: "restarted"
Response
application/json
{
  "stream_target": {
    "state": "restarted"
  }
}

Configure a property for a transcoder

Request

This operation configures a single property or an array of properties for a transcoder.

For a comprehensive resource describing the use of advanced properties, see Set advanced properties with the Wowza Video REST API.

Path
transcoder_idstringrequired

The unique alphanumeric string that identifies the transcoder.

Bodyapplication/jsonrequired

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:
propertyobject(property)required

The single property to configure. The property configuration consists of a key/value pair and the section of the transcoder configuration table the key/value pair is stored in.

property.​keystringrequired

The key of the property.

The following table lists the available property keys and what transcoder table section they're stored in.

SectionValid keys for the section
asset_management
  • enabled

Note: You need a Wowza Video subscription to access Asset Management.
cupertino
  • aes128Host
  • aes128Secret
ezdrm
  • username
  • password
  • fairPlayAssetId
  • wideVineContentId
file
  • repeat
  • start_streaming_at
output
  • fitMode
  • record
recording
  • mp4
rtmp
  • allowDirectPlayback
rtsp
  • avSyncMethod
  • debugRtspSession
  • maxRtcpWaitTime
  • rtpDePacketizerPacketSorterBufferTime
  • rtpDePacketizerPacketSorterFlushTime
  • rtpDePacketizerWrapper
  • rtpIgnoreSpropParameterSets
  • rtpIgnoreProfileLevelId
  • rtpTransportMode
  • rtspValidationFrequency
  • rtspFilterUnknownTracks
vod_stream
  • hls
  • live2vod

Note: VOD streams require a Fastly stream target with HLS as a delivery protocol.
Example: "rtpIgnoreProfileLevelId"
property.​sectionstringrequired

The section of the transcoder configuration table that contains the property.

Enum"asset_management""cupertino""ezdrm""file""output""recording""rtmp""rtsp""vod_stream"
Example: "rtsp"
property.​valuestringrequired

The value of the property.

The following table provides information about valid values for each property key.

Key(s)Values for the key
aes128HostSpecify the URL that devices will use to fetch the key to decrypt the stream.
aes128SecretSpecify the 16-byte key that will be used to decrypt the stream. The key must be 32 characters in length and can only contain hex characters (a-f, A-F, 0-9). The key must match the key returned by the aes128Host.
enabledSpecify true or false. Used in the asset_mangement section.
fitModeUse letterbox, fit-width, fit-height, crop, stretch, or match-source. The default is fit-height.
maxRtcpWaitTimeUse a whole number, expressed as a string or an integer. The default is 2000 (ms).
recordUse an output ID associated with the transcoder.
rtpDePacketizerPacketSorterBufferTimeUse an integer, expressed as a string or an integer. The default is 500 (ms).
rtpDePacketizerPacketSorterFlushTimeUse an integer, expressed as a string or an integer. The default is 10 (ms).
rtpDePacketizerWrapperUse the string RTPDePacketizerWrapperPacketSorter.
rtpTransportModeUse the string udp or interleave (the default).
rtspValidationFrequencyUse a whole number, expressed as a string or an integer. The default is 15000 (ms).
start_streaming_atSpecify the month, day, year, and time of day that the file should start streaming, expressed as a string. Express the value by using the ISO 8601 standard of YYYY-MM-DDTHH:MM:SSZ where HH is a 24-hour clock in UTC.
  • **username**
  • **password**
  • **fairplayAssetId**
  • **wideVineContentId**
| Use account information and asset IDs from EZDRM. All strings.
  • **avSyncMethod**
  • **debugRtspSession**
  • **mp4**
  • **repeat**
  • **rtspFilterUnknownTracks**
  • **rtpIgnoreSpropParameterSets**
  • **rtpIgnoreProfileLevelId**
| Use **true** or **false**, expressed as a string or a Boolean.
  • **hls**
  • **live2vod**
| Use **true** or **false**, expressed as a string or a Boolean. When **true**, **hls** generates a VOD stream and **live2vod** replaces the live playlist with the VOD playlist after the stream ends so viewers can access the VOD stream on the live playback URL. **hls** must be **true** to enable **live2VOD**.
Example: "true"
curl -i -X POST \
  'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/transcoders/{transcoder_id}/properties' \
  -H 'Content-Type: application/json' \
  -d '{
    "property": {
      "key": "rtpIgnoreProfileLevelId",
      "section": "rtsp",
      "value": "true"
    }
  }'

Responses

Success

Bodyapplication/json
One of:
propertyobject(property)required

A single property. The property configuration consists of a key/value pair and the section of the transcoder configuration table the key/value pair is stored in.

property.​keystringrequired

The key of the property.

The following table lists the available property keys and what transcoder table section they're stored in.

SectionValid keys for the section
asset_management
  • enabled

Note: You need a Wowza Video subscription to access Asset Management.
cupertino
  • aes128Host
  • aes128Secret
ezdrm
  • username
  • password
  • fairPlayAssetId
  • wideVineContentId
file
  • repeat
  • start_streaming_at
output
  • fitMode
  • record
recording
  • mp4
rtmp
  • allowDirectPlayback
rtsp
  • avSyncMethod
  • debugRtspSession
  • maxRtcpWaitTime
  • rtpDePacketizerPacketSorterBufferTime
  • rtpDePacketizerPacketSorterFlushTime
  • rtpDePacketizerWrapper
  • rtpIgnoreSpropParameterSets
  • rtpIgnoreProfileLevelId
  • rtpTransportMode
  • rtspValidationFrequency
  • rtspFilterUnknownTracks
vod_stream
  • hls
  • live2vod

Note: VOD streams require a Fastly stream target with HLS as a delivery protocol.
Example: ""
property.​sectionstringrequired

The section of the transcoder configuration table that contains the property.

Enum"asset_management""cupertino""ezdrm""file""output""recording""rtmp""rtsp""vod_stream"
Example: ""
property.​valuestringrequired

The value of the property.

The following table provides information about valid values for each property key.

Key(s)Values for the key
aes128HostSpecify the URL that devices will use to fetch the key to decrypt the stream.
aes128SecretSpecify the 16-byte key that will be used to decrypt the stream. The key must be 32 characters in length and can only contain hex characters (a-f, A-F, 0-9). The key must match the key returned by the aes128Host.
enabledSpecify true or false. Used in the asset_mangement section.
fitModeUse letterbox, fit-width, fit-height, crop, stretch, or match-source. The default is fit-height.
maxRtcpWaitTimeUse a whole number, expressed as a string or an integer. The default is 2000 (ms).
recordUse an output ID associated with the transcoder.
rtpDePacketizerPacketSorterBufferTimeUse an integer, expressed as a string or an integer. The default is 500 (ms).
rtpDePacketizerPacketSorterFlushTimeUse an integer, expressed as a string or an integer. The default is 10 (ms).
rtpDePacketizerWrapperUse the string RTPDePacketizerWrapperPacketSorter.
rtpTransportModeUse the string udp or interleave (the default).
rtspValidationFrequencyUse a whole number, expressed as a string or an integer. The default is 15000 (ms).
start_streaming_atSpecify the month, day, year, and time of day that the file should start streaming, expressed as a string. Express the value by using the ISO 8601 standard of YYYY-MM-DDTHH:MM:SSZ where HH is a 24-hour clock in UTC.
  • **username**
  • **password**
  • **fairplayAssetId**
  • **wideVineContentId**
| Use account information and asset IDs from EZDRM. All strings.
  • **avSyncMethod**
  • **debugRtspSession**
  • **mp4**
  • **repeat**
  • **rtspFilterUnknownTracks**
  • **rtpIgnoreSpropParameterSets**
  • **rtpIgnoreProfileLevelId**
| Use **true** or **false**, expressed as a string or a Boolean.
  • **hls**
  • **live2vod**
| Use **true** or **false**, expressed as a string or a Boolean. When **true**, **hls** generates a VOD stream and **live2vod** replaces the live playlist with the VOD playlist after the stream ends so viewers can access the VOD stream on the live playback URL. **hls** must be **true** to enable **live2VOD**.
Example: ""
Response
application/json
{
  "property": [
    { … }
  ]
}

Fetch a transcoder's properties

Request

This operation shows all of the properties of a specific transcoder.

Path
transcoder_idstringrequired

The unique alphanumeric string that identifies the transcoder.

curl -i -X GET \
  'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/transcoders/{transcoder_id}/properties'

Responses

Success

Bodyapplication/json
propertiesArray of objects(property)

An array of properties.

Example: [{"key":"fitMode","section":"output","value":"letterbox"},{"key":"rtpIgnoreProfileLevelId","section":"rtsp","value":true}]
Response
application/json
{
  "properties": [
    { … },
    { … }
  ]
}

Stream Sources

Operations related to stream sources. You can create a Wowza stream source and associate it to a live stream or transcoder.

Operations

Stream Targets

Operations related to stream targets. A stream target is a destination for a stream. Stream targets can be Wowza Video edge resources; custom, external destinations target destinations.

Operations

Assets

Operations related to assets, which are created through the /assets resources. The Wowza Video service can store and transcode mp4 files that you can tag, manage, and restream.

Operations

Recordings

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

Schedules

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

VOD Streams

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

Real-Time Streams

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

Viewers

Operations related to viewer analytics.

Operations

Ingest

Operations related to ingest analytics for a live stream.

Operations

Engagement

Operations related to engagement analytics for a VOD stream.

Operations

Popularity

Operations related to popularity analytics.

Operations

Account

Operations related to stream analytics for an account.

Operations

Transcoders

Operations related to transcoder analytics.

Operations

Stream Targets

Operations related to stream target analytics, including CDN usage and viewer data.

Operations

Storage

Operations related to peak storage for an account. You can use this operation to show the amount of peak recording and VOD stream storage used by your account.

Operations

VOD Streams

Operations related to video on demand (VOD) stream analytics.

Operations

Real Time Streams

Operations related to real-time streams analytics.

Operations