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
/
Create an asset
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/assets
- https://api.video.wowza.com/api/v1.11/assets
- curl
- Java
- Python
- JavaScript
curl -i -X POST \
https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/assets \
-H 'Content-Type: application/json' \
-d '{
"asset": {
"file_name": "MyAsset.mp4"
}
}'Success
Example: {"id":"2adffc17","created_at":"2021-06-30T18:02:20.000Z","file_name":"MyAsset.mp4","upload_url":"https://objectstorage.us-ashburn-1.oraclecloud.com/p/k9bGRcyPFPtdeQeTRgAVTByIVVS0Z_EKrLBu3TusTrRfBuIpoDyio_ZY3qJM55tp/n/a1b2c3d4e5f6/b/recordings-qa-S7I69eYn/o/uploads/recording_bry7vv0s/MyAsset.mp4"}
The unique identifier of the asset. Use this ID to perform other operations on the stream, like getting the details of the asset or deleting it.
Example: "2adffc17"
The date and time that the asset was created in Coordinated Universal Time (UTC) format. Dates are formatted as follows: YYYY-DD-MMT HH:MM:SSZ using 24-hour clock ("military") time and including the T and Z. The T marks the end of the date portion and the Z represents zero UTC time offset.
Example: "2021-06-30T18:02:20.000Z"
The name of the mp4 file you are uploading.
Note: To avoid file management issues in storage, Wowza Video removes or replaces special characters in file names.
Example: "MyAsset.mp4"
The upload location for the asset. Use this URL to upload the .mp4 assets to the Wowza Video Asset Manager.
Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/p/k9bGRcyPFPtdeQeTRgAVTByIVVS0Z_EKrLBu3TusTrRfBuIpoDyio_ZY3qJM55tp/n/a1b2c3d4e5f6/b/recordings-qa-S7I69eYn/o/uploads/recording_bry7vv0s/MyAsset.mp4"
Response
application/json
{ "asset": { "id": "2adffc17", "created_at": "2021-06-30T18:02:20.000Z", "file_name": "MyAsset.mp4", "upload_url": "https://objectstorage.us-ashburn-1.oraclecloud.com/p/k9bGRcyPFPtdeQeTRgAVTByIVVS0Z_EKrLBu3TusTrRfBuIpoDyio_ZY3qJM55tp/n/a1b2c3d4e5f6/b/recordings-qa-S7I69eYn/o/uploads/recording_bry7vv0s/MyAsset.mp4" } }
Query
Restricts the data that gets returned by filtering on one or more values associated with a field. For more information and examples, see the technical article How to get filtered query results with the Wowza Video REST API.
Example: filter[0][field]=created_at&filter[0][gte]=2021-07-14T17:47:45.000Z
Restricts the data that gets returned by querying on one or more values associated with a set of fields. For more information and examples, see the technical article How to get filtered query results with the Wowza Video REST API.
Example: sort_direction=desc&sort_column=created_at&per_page=30&state=completed&query=sample
Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1.
For more information and examples, see Get paginated query results with the Wowza Video REST API.
- Mock serverhttps://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/assets
- https://api.video.wowza.com/api/v1.11/assets
- curl
- Java
- Python
- JavaScript
curl -i -X GET \
'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/assets?filter=string&query=string&page=0&per_page=0'Success
Example: [{"id":"wdjfqvsv","name":"MyAsset","created_at":"2020-01-29T17:16:21.849Z","updated_at":"2020-01-31T16:06:47.849Z","published":true,"thumbnail_url":"https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/0pfxrlw2_thumbnail.jpg.jpg","state":"completed","processing_percentage":0.1,"file_size":1570024,"playback_url":"https://wowzasubdomain/1/RmlPcnpsM0Z1Nzd2/SFhkUXlv/hls/live/playlist.m3u8","download_url":"https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/MyAsset.mp4","file_name":"MyFile.mp4"},{"id":"KyxWKtHQ","name":"MyAsset2","created_at":"2020-01-29T17:16:21.849Z","updated_at":"2020-01-31T02:26:05.849Z","published":true,"thumbnail_url":"https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/0pfxrlw2_thumbnail.jpg.jpg","state":"completed","processing_percentage":0.3,"file_size":70284,"playback_url":"https://wowzasubdomain/1/U0VmOU90TmtvSzJP/Y2ltUkl2/hls/live/playlist.m3u8","download_url":"https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/MyAsset2.mp4","file_name":"MyFile2.mp4"},{"id":"Ly40ZDSg","name":"MyAsset3","created_at":"2020-01-29T17:16:21.849Z","updated_at":"2020-01-30T18:13:18.849Z","published":true,"thumbnail_url":"https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/0pfxrlw2_thumbnail.jpg.jpg","state":"completed","processing_percentage":0,"file_size":882391,"playback_url":"https://wowzasubdomain/1/PmlPcnpsM0Z1Nzd2/SFhkUXlv/hls/live/playlist.m3u8","download_url":"https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/MyAsset3.mp4","file_name":"MyFile3.mp4"}]
The date and time that the asset was created in Coordinated Universal Time (UTC) format. Dates are formatted as follows: YYYY-DD-MMT HH:MM:SSZ using 24-hour clock ("military") time and including the T and Z. The T marks the end of the date portion and the Z represents zero UTC time offset. .
Example: ""
The date and time that the asset was updated in Coordinated Universal Time (UTC) format. Dates are formatted as follows: YYYY-DD-MMT HH:MM:SSZ using 24-hour clock ("military") time and including the T and Z. The T marks the end of the date portion and the Z represents zero UTC time offset. .
Example: "2022-02-26T01:38:40.310Z"
The URL to receive the preview thumbnail.
Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/0pfxrlw2_thumbnail.jpg"
The state of the asset.
Enum"uploading""processing""completed""failed"
Example: "completed"
The reason that an asset has the state failed. Only returned when state is failed after processing is attempted.
Example: ""
A percentage that describes how soon transcoding will complete.
Example: "100.0"
The file size of the asset in bytes. For example, 2372820 bytes equals 2.4 megabytes.
Example: ""
The address that can be used to configure playback of the stream.
Example: ""
The URL that can be used to download the asset as a .MP4 file.
Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/MyAsset.mp4"
Response
application/json
{ "assets": [ { … }, { … }, { … } ] }
Request
This operation shows the details of a specific asset.
The fields returned vary depending on when you send this request. For example, if a resource hasn't been created yet during the processing state, you won't see available_renditions in the response.
Tip: If your original upload URL expired and you need a new one for an asset, send this request and the response will contain a new upload URL.
- Mock serverhttps://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/assets/{id}
- https://api.video.wowza.com/api/v1.11/assets/{id}
- curl
- Java
- Python
- JavaScript
curl -i -X GET \
'https://developer.wowza.com/_mock/docs/wowza-video/api/video/v1.11/openapi/assets/{id}'Success
The renditions available for the asset.
Example: [{"height":480,"width":848,"bitrate_kbps":1600}]
A descriptive name for the live stream. Maximum 200 characters.
Example: "My Asset"
A description of the asset. Maximum 16,000 characters.
Example: "My Asset Description"
The upload location for the asset. Use this URL to upload the .mp4 assets to the Wowza Video Asset Manager.
Only returned when the asset is in the uploading state, and returns a new upload URL. Useful if the previous upload URL expired and you need a new one.
Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/p/k9bGRcyPFPtdeQeTRgAVTByIVVS0Z_EKrLBu3TusTrRfBuIpoDyio_ZY3qJM55tp/n/a1b2c3d4e5f6/b/recordings-qa-S7I69eYn/o/uploads/recording_bry7vv0s/MyAsset.mp4"
An ID for the VOD. You can use this to fetch additional information about the VOD stream associated with the asset, such as the size of only the VOD stream.
Example: "l9qsbwvf"
An ID for the recording. You can use this to fetch additional information about the recording associated with the asset.
Example: "l8qsbwvu"
The state of the asset.
Enum"uploading""processing""completed""failed"
Example: "completed"
The reason that an asset has the state failed. Only returned when state is failed after processing is attempted.
Example: ""
The date and time that the asset was created in Coordinated Universal Time (UTC) format. Dates are formatted as follows: YYYY-DD-MMTHH:MM:SSZ using 24-hour clock ("military") time and including the T and Z. The T marks the end of the date portion and the Z represents zero UTC time offset.
Example: "2021-06-30T18:02:20.000Z"
The date and time that the asset was updated in Coordinated Universal Time (UTC) format. Dates are formatted as follows: YYYY-DD-MMTHH:MM:SSZ using 24-hour clock ("military") time and including the T and Z. The T marks the end of the date portion and the Z represents zero UTC time offset.
Example: "2021-06-30T18:02:20.000Z"
The URL that can be used to download the asset as a .MP4 file.
Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/MyAsset.mp4"
The file size of the asset in bytes. For example, 2372820 bytes equals 2.4 megabytes.
Example: 2372820
The length of an asset in seconds. For example, 9241 would represent 9,241 seconds or roughly 2.5 hours.
Example: 9241
The URL to receive the preview thumbnail.
Example: "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/0pfxrlw2_thumbnail.jpg"
The unique_viewers parameter is deprecated. To get unique viewers for an asset, use the GET /analytics/viewers/vod_stream/{id} endpoint.
Example: 5986
The HLS URL for the stream associated with the asset.
Example: "https://cdn3-qa.wowza.com/2/T1R6V2hBV2hEdmJ0/ZnJUOE9q/hls/g7z7bwbz/playlist.m3u8"
The total storage size for the asset in bytes. In this example, 19513598 equals 19.5 megabytes.
Example: 19513598
The name of the mp4 file you uploaded.
Note: To avoid file management issues in storage, Wowza Video removes or replaces special characters in file names.
Example: "MyAsset.mp4"
A percentage that describes how soon transcoding will complete.
Example: 100
The HTML code that can be used in external webpage to host the Wowza Flowplayer.
Example: "<div id='wowza_player'></div>\\n<script id='player_embed' src='//player.video.wowza.com/qa/xhb9jdmc/wowza.js' type='text/javascript'></script>\\n"
Response
application/json
{ "asset": { "available_renditions": [ … ], "id": "i4qsbwvi", "name": "My Asset", "description": "My Asset Description", "published": true, "tags": [ … ], "upload_url": "https://objectstorage.us-ashburn-1.oraclecloud.com/p/k9bGRcyPFPtdeQeTRgAVTByIVVS0Z_EKrLBu3TusTrRfBuIpoDyio_ZY3qJM55tp/n/a1b2c3d4e5f6/b/recordings-qa-S7I69eYn/o/uploads/recording_bry7vv0s/MyAsset.mp4", "vod_stream_id": "l9qsbwvf", "recording_id": "l8qsbwvu", "state": "completed", "reason": "", "created_at": "2021-06-30T18:02:20.000Z", "updated_at": "2021-06-30T18:02:20.000Z", "download_url": "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/MyAsset.mp4", "file_size": 2372820, "duration": 9241, "thumbnail_url": "https://objectstorage.us-ashburn-1.oraclecloud.com/n/idcrz33q3xdo/b/recordings-qa-S7I69eYn/o/abcd1234/recording_0pfxrlw2/0pfxrlw2_thumbnail.jpg", "unique_viewers": 5986, "total_viewing_time": 4492549, "average_view_time": 12580, "playback_url": "https://cdn3-qa.wowza.com/2/T1R6V2hBV2hEdmJ0/ZnJUOE9q/hls/g7z7bwbz/playlist.m3u8", "total_storage_size": 19513598, "file_name": "MyAsset.mp4", "processing_percentage": 100, "player_embed_code": "<div id='wowza_player'></div>\\n<script id='player_embed' src='//player.video.wowza.com/qa/xhb9jdmc/wowza.js' type='text/javascript'></script>\\n", "hosted_page": { … } } }
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