# Update a live stream This operation updates a live stream. Endpoint: PATCH /live_streams/{id} Version: v2.0 ## Path parameters: - `id` (string, required) The unique alphanumeric string that identifies the live stream. ## Request fields (application/json): - `live_stream` (object, required) Example: {"name":"My Updated Live Stream","description":"This is my first live stream.","recording":true} - `live_stream.aspect_ratio_height` (integer) The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. Combined with aspect_ratio_width, makes up the input resolution. Default: 720. Example: "aspect_ratio_height": 720 Example: 1080 - `live_stream.aspect_ratio_width` (integer) The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. Combined with aspect_ratio_height, makes up the input resolution. Default: 1280. Example: "aspect_ratio_width": 1280 Example: 1920 - `live_stream.encoder` (string) The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Video transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp. Example: "encoder": "other_rtmp" Enum: "wowza_clearcaster", "wowza_gocoder", "wowza_streaming_engine", "media_ds", "axis", "epiphan", "file", "hauppauge", "jvc", "live_u", "matrox", "newtek_tricaster", "osprey", "sony", "telestream_wirecast", "teradek_cube", "vmix", "x_split", "ipcamera", "other_rtmp", "other_rtsp", "other_webrtc", "other_udp", "other_srt" - `live_stream.name` (string) A descriptive name for the live stream. Maximum 200 characters. Example: "name": "My Updated Live Stream" Example: "My Updated Live Stream" - `live_stream.closed_caption_type` (string) The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioning data streams are being provided. Example: "closed_caption_type": "cea" Enum: "none", "cea", "on_text", "both" - `live_stream.delivery_method` (string) The type of connection between the video source and the transcoder. The default, push, instructs the source to push the stream to the transcoder. pull instructs the transcoder to pull the video from the source. cdn uses a stream source to deliver the stream to the transcoder. Example: "delivery_method": "pull" Enum: "pull", "cdn", "push" - `live_stream.delivery_protocols` (array) An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, webrtc, and wowz are enabled. Example: See response body sample - `live_stream.description` (string) An optional description of the live stream. Example: "This is my first live stream." - `live_stream.disable_authentication` (boolean) Authentication is required by default for RTMP and RTSP push connections from a video source to Wowza Video. Specify true to disable authentication with the video source. Example: "disable_authentication": false - `live_stream.hosted_page` (object) Configuration of the hosted page. - `live_stream.hosted_page.enabled` (boolean) A web page hosted by Wowza Video that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page. Example: "enabled": true - `live_stream.hosted_page.description` (string) A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. Example: "description": "My Hosted Page Description" - `live_stream.hosted_page.logo_image` (string) A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. Example: "logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]" Example: "[Base64-encoded string representation of GIF, JPEG, or PNG file]" - `live_stream.hosted_page.remove_logo_image` (boolean) If true, removes the logo file from the hosted page. The default is false. Example: "remove_logo_image": true Example: true - `live_stream.hosted_page.sharing_icons` (boolean) Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons. Example: "sharing_icons": false - `live_stream.hosted_page.title` (string) A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. Example: "title": "My Hosted Page" - `live_stream.password` (string) A password for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. Example: "password": 68332313 Example: "68332313" - `live_stream.player` (object) The player object is deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player object will be ignored. The following fields have been moved outside of the player object and reside within the live_stream object where you can still access them through the API: * logo_image * logo_position * video_poster_image * width * remove_video_poster_image * remove_logo_image - `live_stream.player.customizations` (object) Configuration of the player customizations. - `live_stream.player.customizations.play_icon` (string) A play icon that is displayed on the video preview. The default, solid, uses the standard play (solid triangle) icon. outlined uses an alternate (outlined triangle) play icon. ring uses an alternate (small solid triangle enclosed in a circle) play icon. Default: solid Example: "play_icon": "solid" Enum: "solid", "outlined", "ring" - `live_stream.player.customizations.thin_timeline` (boolean) If true, displays a thinner control bar than the default in the video. The default is false. Example: "thin_timeline": false - `live_stream.player.customizations.drag_handle` (boolean) If true, displays a drag handle on the progress bar. The default is false. Example: "drag_handle": false - `live_stream.player.customizations.volume` (boolean) If true, displays a volume button on the video. The default is true. Example: "volume": true - `live_stream.player.customizations.mute` (boolean) If true, displays a mute button on the video. The default is true. Example: "mute": true - `live_stream.player.customizations.fullscreen` (boolean) If true, displays a fullscreen button on the video. The default is true. Example: "fullscreen": true - `live_stream.player.customizations.show_player_title` (boolean) If true, displays a preview title on the video. The default is false. Example: "show_player_title": false - `live_stream.player.customizations.color` (string) The color of the timeline and volume bar of the player. You can set the color of your choice by passing a hex code for that specific color. Example: "color": "4d4d4d" - `live_stream.player.countdown` (boolean) A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false. Example: "countdown": false - `live_stream.player.countdown_at` (string) The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC. Example: "countdown_at": "2020-02-01T17:00:00.000Z" - `live_stream.player.logo_image` (string) A Base64-encoded string representation of a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. Example: "logo_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]" - `live_stream.player.logo_position` (string) The corner of the player in which you want the player logo to appear. The default is top-left. Example: "logo_position": "top-right" Enum: "top-left", "top-right", "bottom-left", "bottom-right" - `live_stream.player.plugins` (object) Configuration of the plugins. - `live_stream.player.plugins.airplay` (boolean) If true, enables Airplay functionality in the player which allows you to cast to an Airplay device. The default is false. Example: "airplay": false - `live_stream.player.plugins.chromecast` (boolean) If true, enables Chromecast functionality in the player which allows you to cast to a Chromecast device. The default is false. Example: "chromecast": false - `live_stream.player.remove_logo_image` (boolean) If true, removes the logo file from the player. The default is false. Example: "remove_logo_image": true Example: true - `live_stream.player.remove_video_poster_image` (boolean) If true, removes the poster image. The default is false. Example: "remove_video_poster_image": true Example: true - `live_stream.player.responsive` (boolean) A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width. Example: "type": false - `live_stream.player.type` (string) The player you want to use. Wowza Video subscribers Wowza Flowplayer (wowza_flowplayer) is the only valid option. You're a subscriber if you have access to Asset Management and Historic and Live Analytics in the user interface. The Wowza Flowplayer is an easy-to-use, commercial grade player designed for builders and developers. It provides HTML5, HLS, and MPEG-DASH playback and plays streams on any browser and device. It can be [customized](https://www.wowza.com/docs/embed-and-customize-wowza-flowplayer-in-your-site) if you embed it in your site. Other subscribers original _html5 and wowza_player are the only valid options and original_html5 is the default. original_html5 provides HTML5 playback and falls back to Flash on older browsers. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. Example: "type": "wowza_flowplayer" - `live_stream.player.video_poster_image` (string) The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. Example: "video_poster_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]" - `live_stream.player.width` (integer) The width, in pixels, of a fixed-size player. The default is 640. Example: "width": 640 - `live_stream.player_id` (string) (Available from version 2.0) The unique alphanumeric string that identifies the player configuration to use for this stream. When you pass a player configuration ID, Wowza Video uses that player configuration to customize and style the player. If you don't pass a value, the default player configuration for the account is used. Create and edit player configurations in the user interface. The ID is on the General tab for the player configuration. Default: Default player configuration Example: 2205b4e8-b160-43c2-868d-d88698a4e850 - `live_stream.recording` (boolean) If true, creates a recording of the live stream. The recording starts when the live stream starts and stops automatically when the live stream stops. Recordings created from a live stream capture up to eight hours of content. If a live stream runs for longer than eight hours, the most recent eight hours are recorded. To record more than eight hours of a single broadcast, stop the live stream and start it again to create multiple recordings. Default: false > Note: If save_asset is true, that field overrides a true recording value and the asset is saved in Asset Management. Example: "recording": true Example: true - `live_stream.reference_id` (string) A unique, alphanumeric ID returned in transcoder webhook payloads. Setting a reference_id is useful if you have an ID in your system or application you want to associate with transcoder events that trigger webhooks. Maximum 70 characters. Can only contain: a-z A-Z 0-9 !@#$%^&*()-_+=:;,.?~| You can't use brackets or quotation marks. See Wowza Video Webhook Event Reference Documentation to learn about webhooks. Available from version 1.7. Example: "reference_id": "mySystemID_01" Example: "mySystemID_01" - `live_stream.save_asset` (boolean) If true, saves an MP4 recording and a VOD asset in Asset Management. The default is false. You can't set save_asset for a live stream created from re-streaming an asset in Asset Management > Note: If this value is true, recording and/or vod_stream are set to false. You need a Wowza Video subscription to access Asset Management. Available from version 1.8. Example: "save_asset": true - `live_stream.security` (object) Configuration of stream security. These settings only apply to Wowza CDN on Fastly stream targets, not Facebook Live, LinkedIn Live, or custom targets. - `live_stream.security.force_ssl_playback` (boolean) If true, requires users to play the stream over HTTPS. If false, the default, users can play the stream over HTTPS or HTTP. Example: "force_ssl_playback": true - `live_stream.security.geoblock_enabled` (boolean) If true, controls access to the stream from specific locations and, optionally, IP addresses. The default is false. Example: "geoblock_enabled": true - `live_stream.security.geoblock_by_location` (string) Specifies whether to allow or deny access to the stream from specific locations. The default is disabled. Example: "geoblock_location": "allow" Enum: "allow", "deny", "disabled" - `live_stream.security.geoblock_country_codes` (string) Required when geoblock_by_location is allow or deny. The locations affected by the geo-blocking. Enter a comma-separated list of capitalized two-letter ISO 3166-1 country codes. For a list, see [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) on Wikipedia. Example: "geoblock_country_codes": "CA, DE" - `live_stream.security.geoblock_ip_override` (string) Specifies whether specific IP addresses can override the locations that are allowed or restricted. allow permits access from IP addresses within a location that's been blocked, while deny restricts access from IP addresses within locations that are allowed. The default is disabled. Example: "geoblock_ip_override": "allow" Enum: "allow", "deny", "disabled" - `live_stream.security.geoblock_ip_addresses` (string) Required when geoblock_ip_override is allow or deny. Addresses that can access or restrict the stream even if they're within a specified geo-blocked location. Enter a comma-separated list of up to about 40 IPv4 and IPv6 IP addresses that always allow or deny streaming based on the geoblock_ip_override value. Troubleshooting: The limit of 40 IP addresses is approximate because all the security information (SSL playback, geoblocking countries and IP addresses, referer header, and token auth) count toward an overall metadata limit. Example: "geoblock_ip_addresses": "77.12.34.567, 78.23.45.678" - `live_stream.security.token_auth_enabled` (boolean) If true, token authentication protects the stream by ensuring that it's delivered only to authorized viewers and can't be shared by unauthorized links or player hijacking attacks. The default is false. Example: "token_auth_enabled": true - `live_stream.security.token_auth_shared_secret` (string) The shared secret of the token authentication. Must contain only hexadecimal characters and be an even number of total characters not exceeding 32. Example: "token_auth_shared_secret": "12345678ABCDEF" - `live_stream.security.token_auth_playlist_only` (boolean) If true, Wowza Video uses token authentication to protect the master playlist only and leaves individual media playlists and media segments unprotected. This feature enables playback compatibility with media players that don’t support the withCredentials property. It may also be useful when addressing token auth compatibility issues with specific browsers. The default is false. Note: If you've enabled MPEG-DASH on your stream target, token_auth_playlist_only applies to both the playlist.m3u8 for HLS and manifest.mpd for MPEG-DASH. Example: "token_auth_playlist_only": true - `live_stream.source_url` (string) For the delivery_method pull or encoder file. For pull, enter the URL of an IP camera or video encoder using an RTMP and RTSP pull connection to Wowza Video. Consult the camera or encoder documentation for the URL syntax. For file, enter the source file URL, including the protocol (http, https, gs, s3). Example: "source_url": "xyz.streamlock.net/vod/mp4:Movie.mov" Example: "xyz.streamlock.net/vod/mp4:Movie.mov" - `live_stream.target_delivery_protocol` (string) The type of stream being delivered from Wowza Video. The default and only valid value is hls-https. Example: "target_delivery_protocol": "hls-https" Enum: "hls-https" - `live_stream.use_stream_source` (boolean) If true, uses a stream source to deliver the stream to Wowza Video. The default, false, pushes directly to Wowza Video. Example: "use_stream_source": false - `live_stream.username` (string) A user name for authenticating an RTMP or RTSP push connection. Can contain only uppercase and lowercase letters; numbers; and the period (.), underscore (_), and hyphen (-) characters. No other special characters can be used. Example: "username": "client2" Example: "client2" - `live_stream.vod_stream` (boolean) If true, creates a VOD stream after the live stream ends. The default is false.VOD streams require a Fastly stream target with HLS as a delivery protocol. > Note: If save_asset is true, that field overrides a true vod_stream value and the asset is saved in Asset Management. Example: "vod_stream": true Example: true - `live_stream.watermark` (boolean) Embeds an image into the transcoded stream for copyright protection. Specify true to embed a watermark image. Example: "watermark": true - `live_stream.watermark_height` (integer) The height, in pixels, of the watermark image. If blank, Wowza Video uses the original image height. Example: "watermark_height": 80 - `live_stream.watermark_image` (string) A Base64-encoded string representation of a GIF, JPEG, or PNG image that is embedded in all bitrate renditions of the stream. Watermark image files must be 2.5 MB or smaller. Example: "watermark_image": "[Base64-encoded string representation of GIF, JPEG, or PNG file]" - `live_stream.watermark_opacity` (integer) The opacity, or percentage of transparency, of the watermark. 0 is fully transparent; 100 is fully opaque. Example: "watermark_opacity": 75 Enum: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100 - `live_stream.watermark_position` (string) The corner of the video frame in which you want the watermark to appear. The default is top-left. Example: "watermark_position": "top-left" Enum: "top-left", "top-right", "bottom-left", "bottom-right" - `live_stream.watermark_width` (integer) The width, in pixels, of the watermark image. If blank, Wowza Video uses the original image width. Example: "watermark_width": 100 - `live_stream.countdown` (boolean) Enables or disables a countdown timer. - `live_stream.countdown_at` (string) The month, day, year, and time of day that the countdown timer should stop displaying to the viewer. Specify YYYY-MM-DD HH:MM:SS. For example, if you set the countdown_at for 2024-12-15T17:00:00:000Z and the countdown_timezone as America/New_York, the viewer would see their current time minus the time remaining until the date and time you set. So, if there's 5 hours to go until 1700 NYC time for the viewer, the viewer sees 5:00:00 on the player indicating there are 5 hours left, then the timer counts down from there. The countdown starts as soon as the streamer configures it. Required when countdown is true. Example: "countdown_at": "2024-02-01T00:00:00.000Z" Example: "2024-02-01T00:00:00.000Z" - `live_stream.countdown_timezone` (string) The time zone the countdown timer runs in. Required when countdown is true. Click to expand for the full list of valid values | Locations | Wowza Video time_zone value | |---|---| | International Date Line West | Etc/GMT+12 | | Midway Island | Pacific/Midway | | American Samoa | Pacific/Pago_Pago | | Hawaii | Pacific/Honolulu | | Alaska | America/Juneau | | Pacific Time (US & Canada) | America/Los_Angeles | | Tijuana | America/Tijuana | | Mountain Time (US & Canada) | America/Denver | | Arizona | America/Phoenix | | Chihuahua | America/Chihuahua | | Mazatlan | America/Mazatlan | | Central Time (US & Canada) | America/Chicago | | Saskatchewan | America/Regina | | Guadalajara | America/Mexico_City | | Mexico City | America/Mexico_City | | Monterrey | America/Monterrey | | Central America | America/Guatemala | | Eastern Time (US & Canada) | America/New_York | | Indiana (East) | America/Indiana/Indianapolis | | Bogota | America/Bogota | | Lima | America/Lima | | Quito | America/Lima | | Atlantic Time (Canada) | America/Halifax | | Caracas | America/Caracas | | La Paz | America/La_Paz | | Santiago | America/Santiago | | Newfoundland | America/St_Johns | | Brasilia | America/Sao_Paulo | | Buenos Aires | America/Argentina/Buenos_Aires | | Montevideo | America/Montevideo | | Georgetown | America/Guyana | | Puerto Rico | America/Puerto_Rico | | Greenland | America/Godthab | | Mid-Atlantic | Atlantic/South_Georgia | | Azores | Atlantic/Azores | | Cape Verde Is. | Atlantic/Cape_Verde | | Dublin | Europe/Dublin | | Edinburgh | Europe/London | | Lisbon | Europe/Lisbon | | London | Europe/London | | Casablanca | Africa/Casablanca | | Monrovia | Africa/Monrovia | | UTC | Etc/UTC | | Belgrade | Europe/Belgrade | | Bratislava | Europe/Bratislava | | Budapest | Europe/Budapest | | Ljubljana | Europe/Ljubljana | | Prague | Europe/Prague | | Sarajevo | Europe/Sarajevo | | Skopje | Europe/Skopje | | Warsaw | Europe/Warsaw | | Zagreb | Europe/Zagreb | | Brussels | Europe/Brussels | | Copenhagen | Europe/Copenhagen | | Madrid | Europe/Madrid | | Paris | Europe/Paris | | Amsterdam | Europe/Amsterdam | | Berlin | Europe/Berlin | | Bern | Europe/Zurich | | Zurich | Europe/Zurich | | Rome | Europe/Rome | | Stockholm | Europe/Stockholm | | Vienna | Europe/Vienna | | West Central Africa | Africa/Algiers | | Bucharest | Europe/Bucharest | | Cairo | Africa/Cairo | | Helsinki | Europe/Helsinki | | Kyiv | Europe/Kiev | | Riga | Europe/Riga | | Sofia | Europe/Sofia | | Tallinn | Europe/Tallinn | | Vilnius | Europe/Vilnius | | Athens | Europe/Athens | | Istanbul | Europe/Istanbul | | Minsk | Europe/Minsk | | Jerusalem | Asia/Jerusalem | | Harare | Africa/Harare | | Pretoria | Africa/Johannesburg | | Kaliningrad | Europe/Kaliningrad | | Moscow | Europe/Moscow | | St. Petersburg | Europe/Moscow | | Volgograd | Europe/Volgograd | | Samara | Europe/Samara | | Kuwait | Asia/Kuwait | | Riyadh | Asia/Riyadh | | Nairobi | Africa/Nairobi | | Baghdad | Asia/Baghdad | | Tehran | Asia/Tehran | | Abu Dhabi | Asia/Muscat | | Muscat | Asia/Muscat | | Baku | Asia/Baku | | Tbilisi | Asia/Tbilisi | | Yerevan | Asia/Yerevan | | Kabul | Asia/Kabul | | Ekaterinburg | Asia/Yekaterinburg | | Islamabad | Asia/Karachi | | Karachi | Asia/Karachi | | Tashkent | Asia/Tashkent | | Chennai | Asia/Kolkata | | Kolkata | Asia/Kolkata | | Mumbai | Asia/Kolkata | | New Delhi | Asia/Kolkata | | Kathmandu | Asia/Kathmandu | | Astana | Asia/Dhaka | | Dhaka | Asia/Dhaka | | Sri Jayawardenepura | Asia/Colombo | | Almaty | Asia/Almaty | | Novosibirsk | Asia/Novosibirsk | | Rangoon | Asia/Rangoon | | Bangkok | Asia/Bangkok | | Hanoi | Asia/Bangkok | | Jakarta | Asia/Jakarta | | Krasnoyarsk | Asia/Krasnoyarsk | | Beijing | Asia/Shanghai | | Chongqing | Asia/Chongqing | | Hong Kong | Asia/Hong_Kong | | Urumqi | Asia/Urumqi | | Kuala Lumpur | Asia/Kuala_Lumpur | | Singapore | Asia/Singapore | | Taipei | Asia/Taipei | | Perth | Australia/Perth | | Irkutsk | Asia/Irkutsk | | Ulaanbaatar | Asia/Ulaanbaatar | | Seoul | Asia/Seoul | | Osaka | Asia/Tokyo | | Sapporo | Asia/Tokyo | | Tokyo | Asia/Tokyo | | Yakutsk | Asia/Yakutsk | | Darwin | Australia/Darwin | | Adelaide | Australia/Adelaide | | Canberra | Australia/Melbourne | | Melbourne | Australia/Melbourne | | Sydney | Australia/Sydney | | Brisbane | Australia/Brisbane | | Hobart | Australia/Hobart | | Vladivostok | Asia/Vladivostok | | Guam | Pacific/Guam | | Port Moresby | Pacific/Port_Moresby | | Magadan | Asia/Magadan | | Srednekolymsk | Asia/Srednekolymsk | | Solomon Is. | Pacific/Guadalcanal | | New Caledonia | Pacific/Noumea | | Fiji | Pacific/Fiji | | Kamchatka | Asia/Kamchatka | | Marshall Is. | Pacific/Majuro | | Auckland | Pacific/Auckland | | Wellington | Pacific/Auckland | | Nuku'alofa | Pacific/Tongatapu | | Tokelau Is. | Pacific/Fakaofo | | Chatham Is. | Pacific/Chatham | | Samoa | Pacific/Apia | Default: Etc/UTC Example: America/New_York Example: "America/New_York" ## Response 200 fields (application/json): - `live_stream` (object, required) Example: {"aspect_ratio_height":720,"aspect_ratio_width":1280,"billing_mode":"pay_as_you_go","broadcast_location":"us_west_california","closed_caption_type":"cea","connection_code":"0e15cb","connection_code_expires_at":"2020-11-30T17:16:21.956Z","created_at":"2020-01-29T17:16:21.956Z","delivery_method":"push","delivery_protocols":["rtmp","rtsp","wowz","webrtc"],"description":"This is my first live stream.","direct_playback_urls":{"rtmp":[{"name":"source","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789"},{"name":"webrtc","output_id":"dcxq5q6c","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream6"}],"rtsp":[{"name":"source","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789"},{"name":"webrtc","output_id":"dcxq5q6c","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream6"}],"wowz":[{"name":"source","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789"},{"name":"webrtc","output_id":"dcxq5q6c","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream6"}],"webrtc":[{"name":"source","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead"},{"name":"webrtc","output_id":"dcxq5q6c","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream6"}]},"encoder":"other_rtmp","flowplayer":true,"hosted_page":{"enabled":true,"description":"My Hosted Page Description","logo_image_url":"https://prod.s3.amazonaws.com/uploads/player/hosted_page_logo_image/23424/5bad28.jpg","sharing_icons":true,"title":"My Hosted Page","url":"https://embed.flowplayer.com/hosted/default/e8dk5bf6"},"id":"wdjfqvsv","name":"My PAYG Transcoded WSE Live Stream","playback_stream_name":"wxyz6789","player_id":"205b4e8-b160-43c2-868d-d88698a4e850","player_type":"wowza_flowplayer_v2","embed_code":null,"hls_playback_url":"https://wowzasubdomain.wowza.com/1/TWhoL3BiZnJXMFhmNzZVN3JrZDAwUT09/ZmYxSXRrTERrUlk9/hls/live/playlist.m3u8","logo_image_url":"https://prod.s3.amazonaws.com/uploads/player/logo_image/23424/5bad28.jpg","logo_position":"top-right","video_poster_image_url":"https://prod.s3.amazonaws.com/uploads/player/video_poster_image/23424/5bad28.jpg","width":640,"recording":true,"reference_id":"mySystemID_01","save_asset":false,"security":{"force_ssl_playback":false,"geoblock_enabled":true,"geoblock_by_location":"allow","geoblock_country_codes":"DE, US","geoblock_ip_override":"deny","geoblock_ip_addresses":"77.12.34.567, 78.23.45.678","token_auth_enabled":false,"token_auth_playlist_only":false},"state":"stopped","stream_source_id":"5skrfpyf","stream_targets":[{"id":"klbmg2h8"},{"id":"bnjtdmmc"}],"target_delivery_protocol":"hls-https","transcoder_type":"transcoded","updated_at":"2020-01-31T06:12:39.956Z","use_stream_source":true,"vod_stream":true,"watermark":true,"watermark_height":80,"watermark_image_url":"https://prod.s3.amazonaws.com/uploads/transcoder/watermark_image/12345/4baa13.jpg","watermark_opacity":75,"watermark_position":"top-right","watermark_width":100} - `live_stream.aspect_ratio_height` (integer) The height, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. Combined with aspect_ratio_width, makes up the input resolution. Default: 720. Example: 720 - `live_stream.aspect_ratio_width` (integer) The width, in pixels, of the video source. Should correspond to a widescreen (16:9) or standard (4:3) aspect ratio and be divisible by 8. Combined with aspect_ratio_height, makes up the input resolution. Default: 1280. Example: 1280 - `live_stream.asset_id` (string) Only applies to live streams created from re-streaming an asset in Asset Management. The id for the asset associated with the re-streamed live stream. You can manage this asset in Asset Management. - `live_stream.billing_mode` (string) The billing mode for the stream. Default: pay_as_you_go. pay_as_you_go — Billed as a single event. A single event is use-based and you incur charges for the time spent streaming. twentyfour_seven — Billed as a 24x7 channel. A 24x7 channel is unlimited stream time for one channel. This billing mode doesn't incur overages, since it's unlimited. Enum: "pay_as_you_go", "twentyfour_seven" - `live_stream.broadcast_location` (string) The location of your stream. Choose a location as close as possible to your video source. Enum: "asia_pacific_australia", "asia_pacific_india", "asia_pacific_japan", "asia_pacific_singapore", "asia_pacific_s_korea", "asia_pacific_taiwan", "eu_belgium", "eu_germany", "eu_ireland", "south_america_brazil", "us_central_iowa", "us_east_s_carolina", "us_east_virginia", "us_west_california", "us_west_oregon" - `live_stream.closed_caption_type` (string) The type of closed caption data being passed from the source. The default, none, indicates that no data is being provided. cea indicates that a CEA closed captioning data stream is being provided. on_text indicates that an onTextData closed captioning data stream is being provided. both indicates that both CEA and onTextData closed captioning data streams are being provided. Enum: "none", "cea", "on_text", "both" - `live_stream.connection_code` (string) A six-character, alphanumeric string that allows certain encoders, including Wowza Streaming Engine and the Wowza GoCoder app, to connect with Wowza Video. The code can be used once and expires 24 hours after it's created. Example: "0e15cb" - `live_stream.connection_code_expires_at` (string) The date and time that the connection_code expires. Example: "2020-11-30T17:16:21.956Z" - `live_stream.created_at` (string) The date and time that the live stream was created. Example: "2020-01-29T17:16:21.956Z" - `live_stream.delivery_method` (string) The type of connection between the video source and the transcoder. The default, push, instructs the source to push the stream to the transcoder. pull instructs the transcoder to pull the video from the source. cdn uses a stream source to deliver the stream to the transcoder. Enum: "pull", "cdn", "push" - `live_stream.delivery_protocols` (array) An array of direct delivery protocols enabled for this live stream. By default, rtmp, rtsp, webrtc, and wowz are enabled. Example: ["rtmp","rtsp","wowz","webrtc"] - `live_stream.description` (string) An optional description of the live stream. Example: "This is my first live stream." - `live_stream.direct_playback_urls` (object) A list of direct playback URLs for the live stream's delivery protocols. Each protocol has a URL for the source and a URL for each output rendition. Example: {"rtmp":[{"name":"source","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789"},{"name":"webrtc","output_id":"dcxq5q6c","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"rtmp://abc123.entrypoint.video.wowza.com/app-B8P6K226/wxyz6789_stream6"}],"rtsp":[{"name":"source","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789"},{"name":"webrtc","output_id":"dcxq5q6c","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"rtsp://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream6"}],"wowz":[{"name":"source","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789"},{"name":"webrtc","output_id":"dcxq5q6c","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"wowz://abc123.entrypoint.video.wowza.com:1935/app-B8P6K226/wxyz6789_stream6"}],"webrtc":[{"name":"source","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead"},{"name":"webrtc","output_id":"dcxq5q6c","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream1"},{"name":"V:1280x720+A:128K","output_id":"0g116zkf","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream2"},{"name":"V:854x480+A:128K","output_id":"4qqkwndt","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream3"},{"name":"V:640x360+A:128K","output_id":"0pv8djpg","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream4"},{"name":"V:512x288+A:128K","output_id":"b09xrxjf","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream5"},{"name":"V:320x180+A:128K","output_id":"bvkh2nsz","url":"wss://abc123.entrypoint.video.wowza.com/webrtc-session.json","application_name":"app-B8P6K226","stream_name":"1722aead_stream6"}]} - `live_stream.direct_playback_urls.delivery_protocol` (array) The name of the direct playback protocol. - `live_stream.direct_playback_urls.delivery_protocol.name` (string) The name of the playback URL: source, default, or the output rendition's resolution. - `live_stream.direct_playback_urls.delivery_protocol.output_id` (string) Only for output rendition-based playback URLs, not source playback URLs. The unique alphanumeric string that identifies the output rendition. Example: "dcxq5q6c" - `live_stream.direct_playback_urls.delivery_protocol.url` (string) The playback URL for the source or output rendition. Example: "https://abcdef.dev.entrypoint.video.wowza.com/app-B8P6K226/ngrp:43a23e5a_all/playlist.m3u8" - `live_stream.direct_playback_urls.delivery_protocol.application_name` (string) (WebRTC only) The application name for the WebRTC output. - `live_stream.direct_playback_urls.delivery_protocol.stream_name` (string) (WebRTC only) The stream name for the WebRTC output rendition. - `live_stream.encoder` (string) The video source for the live stream. Choose the type of camera or encoder you're using to connect to the Wowza Video transcoder. If your specific device isn't listed, choose ipcamera, other_rtmp, or other_rtsp. Enum: "wowza_clearcaster", "wowza_gocoder", "wowza_streaming_engine", "media_ds", "axis", "epiphan", "file", "hauppauge", "jvc", "live_u", "matrox", "newtek_tricaster", "osprey", "sony", "telestream_wirecast", "teradek_cube", "vmix", "x_split", "ipcamera", "other_rtmp", "other_rtsp", "other_webrtc", "other_udp", "other_srt" - `live_stream.flowplayer` (boolean) Indicates whether or not the player for the live stream is a Wowza Flowplayer player. True indicates the player is a Wowza Flowplayer player. Our new Wowza Video experience uses Wowza Flowplayer. If you are a Wowza Video legacy subscriber, Wowza Flowplayer is also the player used. False indicates the player is either an original_html5 player or wowza_player. The original HTML and Wowza players are the players available for Wowza Streaming Cloud subscribers. Example: true - `live_stream.hosted_page` (object) Configuration of the hosted page. - `live_stream.hosted_page.enabled` (boolean) A web page hosted by Wowza Video that includes a player for the live stream. The default, true, creates a hosted page. Specify false to not create a hosted web page. - `live_stream.hosted_page.description` (string) A description that appears on the hosted page below the player. Can't include custom HTML, JavaScript, or other tags. - `live_stream.hosted_page.logo_image_url` (string) The path to a GIF, JPEG, or PNG logo file that appears in the upper-left corner of the hosted page. Logo file must be 2.5 MB or smaller. - `live_stream.hosted_page.sharing_icons` (boolean) Icons that let viewers share the stream on Facebook, Google+, Twitter, and by email. The default, true, includes sharing icons on the hosted page. Specify false to omit sharing icons. - `live_stream.hosted_page.title` (string) A title for the page that appears above the player. Can't include custom HTML, JavaScript, or other tags. - `live_stream.hosted_page.url` (string) The URL of the Wowza Video-hosted webpage that viewers can visit to watch the stream. - `live_stream.id` (string) The unique alphanumeric string that identifies the live stream. Example: "wdjfqvsv" - `live_stream.low_latency` (boolean) For streams whose target_delivery_protocol is hls-https. If true, turns off incoming and sort packet buffers and delivers smaller video packets to the player, which can reduce latency as long as networks can handle the increased overhead. The default is false. - `live_stream.name` (string) A descriptive name for the live stream. Maximum 200 characters. Example: "My PAYG Transcoded WSE Live Stream" - `live_stream.playback_stream_name` (string) The stream name used in the direct playback URL. Example: "wxyz6789" - `live_stream.player` (object) The player object is deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player object will be ignored. The following fields have been moved outside of the player object and reside within the live_stream object where you can still access them through the API: * embed_code * hls_playback_url * logo_image_url * logo_position * video_poster_image_url * width - `live_stream.player.customizations` (object) Configuration of the player customizations. - `live_stream.player.customizations.play_icon` (string) A play icon that appears on the video preview. The default, solid, uses the standard play (solid triangle) icon. outlined uses an alternate (outlined triangle) play icon. ring uses an alternate (small solid triangle enclosed in a circle) play icon. Enum: "solid", "outlined", "ring" - `live_stream.player.customizations.thin_timeline` (boolean) A control bar that appears on the video. Specify true to display the control bar on the video. The default is false. - `live_stream.player.customizations.drag_handle` (boolean) A drag handle that you can use to drag the progress of the video on the timeline. Specify true to display the drag handle. The default is false. - `live_stream.player.customizations.volume` (boolean) A volume button that appears on the video. Specify true to display the volume button. The default is true. - `live_stream.player.customizations.mute` (boolean) A mute button that appears on the video. Specify true to display the mute button. The default is true. - `live_stream.player.customizations.fullscreen` (boolean) A fullscreen button that appears on the video. Specify true to display the fullscreen button. The default is true. - `live_stream.player.customizations.show_player_title` (boolean) The player title that appears on the video. Specify true to display the player title. The default is false. - `live_stream.player.customizations.color` (string) The color of the timeline and volume bar of the player. You can set the color of your choice by passing a hex code for that specific color. - `live_stream.player.countdown` (boolean) A clock that appears in the player before the event and counts down to the start of the stream. Specify true to display the countdown clock. The default is false. - `live_stream.player.countdown_at` (string) The date and time that the event starts, used by the countdown clock. Specify YYYY-MM-DD HH:MM:SS, where HH is a 24-hour clock in UTC. - `live_stream.player.embed_code` (string) The HTML code that can be used in an external webpage to host the Wowza Flowplayer. - `live_stream.player.hls_playback_url` (string) The address that can be used to configure playback of the stream using the HLS protocol. - `live_stream.player.id` (string) The unique alphanumeric string that identifies the player. - `live_stream.player.logo_image_url` (string) The path to a GIF, JPEG, or PNG logo file that appears partially transparent in a corner of the player throughout playback. Logo file must be 2.5 MB or smaller. - `live_stream.player.logo_position` (string) The corner of the player in which you want the player logo to appear. The default is top-left. Enum: "top-left", "top-right", "bottom-left", "bottom-right" - `live_stream.player.plugins` (object) Configuration of the plugins. - `live_stream.player.plugins.airplay` (boolean) If true, enables Airplay functionality in the player which allows you to cast to an Airplay device. The default is false. - `live_stream.player.plugins.chromecast` (boolean) If true, enables Chromecast functionality in the player which allows you to cast to a Chromecast device. The default is false. - `live_stream.player.responsive` (boolean) A player whose size adjusts according to the device on which it's being viewed. If true, creates a responsive player. If false, specify a player_width. - `live_stream.player.type` (string) The player you want to use. Wowza Video subscribers Wowza Flowplayer (wowza_flowplayer) is the only valid option. You're a subscriber if you have access to Asset Management and Historic and Live Analytics in the user interface. The Wowza Flowplayer is an easy-to-use, commercial grade player designed for builders and developers. It provides HTML5, HLS, and MPEG-DASH playback and plays streams on any browser and device. It can be [customized](https://www.wowza.com/docs/embed-and-customize-wowza-flowplayer-in-your-site) if you embed it in your site. Other subscribers original _html5 and wowza_player are the only valid options and original_html5 is the default. original_html5 provides HTML5 playback and falls back to Flash on older browsers. wowza_player requires that target_delivery_protocol be hls-https and closed_caption_type be none. - `live_stream.player.video_poster_image_url` (string) The path to a GIF, JPEG, or PNG poster image that appears in the player before the stream begins. Poster image files must be 2.5 MB or smaller. - `live_stream.player.width` (integer) The width, in pixels, of a fixed-size player. The default is 640. - `live_stream.player_id` (string) (Available from version 2.0) The unique alphanumeric string that identifies the player configuration to use for this stream. When you pass a player configuration ID, Wowza Video uses that player configuration to customize and style the player. If you don't pass a value, the default player configuration for the account is used. Create and edit player configurations in the user interface. The ID is on the General tab for the player configuration. Default: Default player configuration Note: player_id is not returned in the response if it's not explicitly sent and the default player configuration is used instead. Example: 2205b4e8-b160-43c2-868d-d88698a4e850 Example: "205b4e8-b160-43c2-868d-d88698a4e850" - `live_stream.player_type` (string) (Available from version 2.0) The type of player associated with the stream. Streams created in legacy Wowza Video have a player type of wowza_flowplayer_v1. Streams created in later versions of Wowza Video have a player type of wowza_flowplayer_v2. Knowing the player type is useful if you've migrated streams from legacy Wowza Video. The player for a stream created in the legacy version of Wowza Video isn't editable in the new platform. Example: wowza_flowplayer_v1 Enum: "wowza_flowplayer_v1", "wowza_flowplayer_v2" - `live_stream.countdown_at` (string) The month, day, year, and time of day that the countdown timer should stop displaying to the viewer. Specify YYYY-MM-DD HH:MM:SS. The response is in UTC time. For example, if you set the countdown_at for 2024-12-15T17:00:00:000Z and the countdown_timezone as America/New_York, the viewer would see their current time minus the time remaining until the date and time you set. So, if there's 5 hours to go until 1700 NYC time for the viewer, the viewer sees 5:00:00 on the player indicating their's 5 hours left and the timer counts down from there. The countdown starts as soon as the streamer configures it. Required when countdown is true. Example: "countdown_at": "2024-02-01T00:00:00.000Z" Example: "2024-02-01T00:00:00.000Z" - `live_stream.countdown_timezone` (string) The time zone the countdown timer runs in. Required when countdown is true. Click to expand for the full list of valid values | Locations | Wowza Video time_zone value | |---|---| | International Date Line West | Etc/GMT+12 | | Midway Island | Pacific/Midway | | American Samoa | Pacific/Pago_Pago | | Hawaii | Pacific/Honolulu | | Alaska | America/Juneau | | Pacific Time (US & Canada) | America/Los_Angeles | | Tijuana | America/Tijuana | | Mountain Time (US & Canada) | America/Denver | | Arizona | America/Phoenix | | Chihuahua | America/Chihuahua | | Mazatlan | America/Mazatlan | | Central Time (US & Canada) | America/Chicago | | Saskatchewan | America/Regina | | Guadalajara | America/Mexico_City | | Mexico City | America/Mexico_City | | Monterrey | America/Monterrey | | Central America | America/Guatemala | | Eastern Time (US & Canada) | America/New_York | | Indiana (East) | America/Indiana/Indianapolis | | Bogota | America/Bogota | | Lima | America/Lima | | Quito | America/Lima | | Atlantic Time (Canada) | America/Halifax | | Caracas | America/Caracas | | La Paz | America/La_Paz | | Santiago | America/Santiago | | Newfoundland | America/St_Johns | | Brasilia | America/Sao_Paulo | | Buenos Aires | America/Argentina/Buenos_Aires | | Montevideo | America/Montevideo | | Georgetown | America/Guyana | | Puerto Rico | America/Puerto_Rico | | Greenland | America/Godthab | | Mid-Atlantic | Atlantic/South_Georgia | | Azores | Atlantic/Azores | | Cape Verde Is. | Atlantic/Cape_Verde | | Dublin | Europe/Dublin | | Edinburgh | Europe/London | | Lisbon | Europe/Lisbon | | London | Europe/London | | Casablanca | Africa/Casablanca | | Monrovia | Africa/Monrovia | | UTC | Etc/UTC | | Belgrade | Europe/Belgrade | | Bratislava | Europe/Bratislava | | Budapest | Europe/Budapest | | Ljubljana | Europe/Ljubljana | | Prague | Europe/Prague | | Sarajevo | Europe/Sarajevo | | Skopje | Europe/Skopje | | Warsaw | Europe/Warsaw | | Zagreb | Europe/Zagreb | | Brussels | Europe/Brussels | | Copenhagen | Europe/Copenhagen | | Madrid | Europe/Madrid | | Paris | Europe/Paris | | Amsterdam | Europe/Amsterdam | | Berlin | Europe/Berlin | | Bern | Europe/Zurich | | Zurich | Europe/Zurich | | Rome | Europe/Rome | | Stockholm | Europe/Stockholm | | Vienna | Europe/Vienna | | West Central Africa | Africa/Algiers | | Bucharest | Europe/Bucharest | | Cairo | Africa/Cairo | | Helsinki | Europe/Helsinki | | Kyiv | Europe/Kiev | | Riga | Europe/Riga | | Sofia | Europe/Sofia | | Tallinn | Europe/Tallinn | | Vilnius | Europe/Vilnius | | Athens | Europe/Athens | | Istanbul | Europe/Istanbul | | Minsk | Europe/Minsk | | Jerusalem | Asia/Jerusalem | | Harare | Africa/Harare | | Pretoria | Africa/Johannesburg | | Kaliningrad | Europe/Kaliningrad | | Moscow | Europe/Moscow | | St. Petersburg | Europe/Moscow | | Volgograd | Europe/Volgograd | | Samara | Europe/Samara | | Kuwait | Asia/Kuwait | | Riyadh | Asia/Riyadh | | Nairobi | Africa/Nairobi | | Baghdad | Asia/Baghdad | | Tehran | Asia/Tehran | | Abu Dhabi | Asia/Muscat | | Muscat | Asia/Muscat | | Baku | Asia/Baku | | Tbilisi | Asia/Tbilisi | | Yerevan | Asia/Yerevan | | Kabul | Asia/Kabul | | Ekaterinburg | Asia/Yekaterinburg | | Islamabad | Asia/Karachi | | Karachi | Asia/Karachi | | Tashkent | Asia/Tashkent | | Chennai | Asia/Kolkata | | Kolkata | Asia/Kolkata | | Mumbai | Asia/Kolkata | | New Delhi | Asia/Kolkata | | Kathmandu | Asia/Kathmandu | | Astana | Asia/Dhaka | | Dhaka | Asia/Dhaka | | Sri Jayawardenepura | Asia/Colombo | | Almaty | Asia/Almaty | | Novosibirsk | Asia/Novosibirsk | | Rangoon | Asia/Rangoon | | Bangkok | Asia/Bangkok | | Hanoi | Asia/Bangkok | | Jakarta | Asia/Jakarta | | Krasnoyarsk | Asia/Krasnoyarsk | | Beijing | Asia/Shanghai | | Chongqing | Asia/Chongqing | | Hong Kong | Asia/Hong_Kong | | Urumqi | Asia/Urumqi | | Kuala Lumpur | Asia/Kuala_Lumpur | | Singapore | Asia/Singapore | | Taipei | Asia/Taipei | | Perth | Australia/Perth | | Irkutsk | Asia/Irkutsk | | Ulaanbaatar | Asia/Ulaanbaatar | | Seoul | Asia/Seoul | | Osaka | Asia/Tokyo | | Sapporo | Asia/Tokyo | | Tokyo | Asia/Tokyo | | Yakutsk | Asia/Yakutsk | | Darwin | Australia/Darwin | | Adelaide | Australia/Adelaide | | Canberra | Australia/Melbourne | | Melbourne | Australia/Melbourne | | Sydney | Australia/Sydney | | Brisbane | Australia/Brisbane | | Hobart | Australia/Hobart | | Vladivostok | Asia/Vladivostok | | Guam | Pacific/Guam | | Port Moresby | Pacific/Port_Moresby | | Magadan | Asia/Magadan | | Srednekolymsk | Asia/Srednekolymsk | | Solomon Is. | Pacific/Guadalcanal | | New Caledonia | Pacific/Noumea | | Fiji | Pacific/Fiji | | Kamchatka | Asia/Kamchatka | | Marshall Is. | Pacific/Majuro | | Auckland | Pacific/Auckland | | Wellington | Pacific/Auckland | | Nuku'alofa | Pacific/Tongatapu | | Tokelau Is. | Pacific/Fakaofo | | Chatham Is. | Pacific/Chatham | | Samoa | Pacific/Apia | Default: Etc/UTC Example: America/New_York Example: "America/New_York" - `live_stream.countdown` (boolean) Enables or disables a countdown timer. - `live_stream.recording` (boolean) If true, creates a recording of the live stream. The recording starts when the live stream starts and stops automatically when the live stream stops. Recordings created from a live stream capture up to eight hours of content. If a live stream runs for longer than eight hours, the most recent eight hours are recorded. To record more than eight hours of a single broadcast, stop the live stream and start it again to create multiple recordings. Default: false. > Note: If save_asset is true, that field overrides a true recording value and the asset is saved in Asset Management. Example: true - `live_stream.reference_id` (string) A unique, alphanumeric ID returned in transcoder webhook payloads. Setting a reference_id is useful if you have an ID in your system or application you want to associate with transcoder events that trigger webhooks. Maximum 70 characters. Can only contain: a-z A-Z 0-9 !@#$%^&*()-_+=:;,.?~| You can't use brackets or quotation marks. See Wowza Video Webhook Event Reference Documentation to learn about webhooks. Available from version 1.7. Example: "mySystemID_01" - `live_stream.save_asset` (boolean) If true, saves an MP4 recording and a VOD asset in Asset Management. The default is false. You can't set save_asset for a live stream created from re-streaming an asset in Asset Management. > Note: If this value is true, recording and/or vod_stream are set to false. You need a Wowza Video subscription to access Asset Management. Available from version 1.8. - `live_stream.security` (object) Configuration of stream security. These settings only apply to Wowza CDN on Fastly stream targets, not Facebook Live, LinkedIn Live, or custom targets. Example: {"force_ssl_playback":false,"geoblock_enabled":true,"geoblock_by_location":"allow","geoblock_country_codes":"DE, US","geoblock_ip_override":"deny","geoblock_ip_addresses":"77.12.34.567, 78.23.45.678","token_auth_enabled":false,"token_auth_playlist_only":false} - `live_stream.security.force_ssl_playback` (boolean) If true, requires users to play the stream over HTTPS. If false, the default, users can play the stream over HTTPS or HTTP. - `live_stream.security.geoblock_enabled` (boolean) If true, controls access to the stream from specific locations and, optionally, IP addresses. The default is false. Example: true - `live_stream.security.geoblock_by_location` (string) Specifies whether to allow or deny access to the stream from specific locations. The default is disabled. Enum: "allow", "deny", "disabled" - `live_stream.security.geoblock_country_codes` (string) Required when geoblock_by_location is allow or deny. The locations affected by the geo-blocking. Enter a comma-separated list of capitalized two-letter ISO 3166-1 country codes. For a list, see [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) on Wikipedia. Example: "DE, US" - `live_stream.security.geoblock_ip_override` (string) Specifies whether specific IP addresses can override the locations that are allowed or restricted. allow permits access from IP addresses within a location that's been blocked, while deny restricts access from IP addresses within locations that are allowed. The default is disabled. Enum: "allow", "deny", "disabled" - `live_stream.security.geoblock_ip_addresses` (string) Required when geoblock_ip_override is allow or deny. Addresses that can access or restrict the stream even if they're within a specified geo-blocked location. Enter a comma-separated list of IPv4 and IPv6 IP addresses that always allow or deny streaming based on the geoblock_ip_override value. Example: "77.12.34.567, 78.23.45.678" - `live_stream.security.token_auth_enabled` (boolean) If true, token authentication protects the stream by ensuring that it's delivered only to authorized viewers and can't be shared by unauthorized links or player hijacking attacks. The default is false. - `live_stream.security.token_auth_shared_secret` (string) The shared secret of the token authentication. Must contain only hexadecimal characters and be an even number of total characters not exceeding 32. - `live_stream.security.token_auth_playlist_only` (boolean) If true, Wowza Video uses token authentication to protect the master playlist only and leaves individual media playlists and media segments unprotected. This feature enables playback compatibility with media players that don’t support the withCredentials property. It may also be useful when addressing token auth compatibility issues with specific browsers. The default is false. Note: If you've enabled MPEG-DASH on your stream target, token_auth_playlist_only applies to both the playlist.m3u8 for HLS and manifest.mpd for MPEG-DASH. - `live_stream.source_connection_information` (object) Details that you can use to manually configure and connect a video source to the live stream. - `live_stream.state` (string) The state of the live stream. Enum: "starting", "stopping", "started", "stopped", "resetting" - `live_stream.stream_source_id` (string) The unique alphanumeric string that identifies the stream source, if a stream source is used. Example: "5skrfpyf" - `live_stream.stream_targets` (array) An array of unique alphanumeric strings that identify the stream targets used by the live stream. A primary_stream_target is a single stream target that automatically gets created for all output renditions (the ABR ladder) created when you create a live stream through a live stream flow. The primary_stream_target cannot be deleted or reassigned. Example: [{"id":"klbmg2h8"},{"id":"bnjtdmmc"}] - `live_stream.stream_targets.id` (string) The unique alphanumeric string that identifies the stream target. Example: "dcxq5q6c" - `live_stream.target_delivery_protocol` (string) The type of stream being delivered from Wowza Video. The default and only valid value is hls-https. Enum: "hls-https" - `live_stream.transcoder_type` (string) The type of transcoder, either transcoded for streams that are transcoded into adaptive bitrate renditions or passthrough for streams that aren't processed by the transcoder. > Note: passthrough isn't supported in the asia_pacific_singapore region. Default: transcoded. Enum: "transcoded", "passthrough" - `live_stream.updated_at` (string) The date and time that the live stream was updated. Example: "2020-01-31T06:12:39.956Z" - `live_stream.use_stream_source` (boolean) If true, uses a stream source to deliver the stream to Wowza Video. The default, false, pushes directly to Wowza Video. Example: true - `live_stream.vod_stream` (boolean) If true, creates a VOD stream after the live stream ends. The default is false. VOD streams require a Fastly stream target with HLS as a delivery protocol. > Note: If save_asset is true, that field overrides a true vod_stream value and the asset is saved in Asset Management. Example: true - `live_stream.watermark` (boolean) Embeds an image into the transcoded stream for copyright protection. Specify true to embed a watermark image. Example: true - `live_stream.watermark_height` (integer) The height, in pixels, of the watermark image. If blank, Wowza Video uses the original image height. Example: 80 - `live_stream.watermark_image_url` (string) The path to a GIF, JPEG, or PNG image that is embedded in all bitrate renditions of the stream. Watermark image files must be 2.5 MB or smaller. Example: "https://prod.s3.amazonaws.com/uploads/transcoder/watermark_image/12345/4baa13.jpg" - `live_stream.watermark_opacity` (integer) The opacity, or percentage of transparency, of the watermark. 0 is fully transparent; 100 is fully opaque. Enum: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100 - `live_stream.watermark_position` (string) The corner of the video frame in which you want the watermark to appear. The default is top-left. Enum: "top-left", "top-right", "bottom-left", "bottom-right" - `live_stream.watermark_width` (integer) The width, in pixels, of the watermark image. If blank, Wowza Video uses the original image width. Example: 100 ## Response 401 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 403 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 404 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 410 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array) ## Response 422 fields (application/json): - `meta` (object, required) - `meta.status` (integer) - `meta.code` (string) - `meta.title` (string) - `meta.message` (string) - `meta.description` (string) - `meta.links` (array)