# Update a transcoder

This operation updates a transcoder.

Endpoint: PATCH /transcoders/{id}
Version: v2.0

## Path parameters:

  - `id` (string, required)
    The unique alphanumeric string that identifies the transcoder.

## Request fields (application/json):

  - `transcoder` (object, required)
    Example: {"name":"My Updated Transcoder","description":"My Transcoder Description","watermark_position":"bottom-left"}

  - `transcoder.delivery_method` (string)
    The type of connection between the source encoder and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder.

Example: "delivery_method": "pull"
    Enum: "pull", "cdn", "push"

  - `transcoder.name` (string)
    A descriptive name for the transcoder. Maximum 200 characters.

Example: "name": "My Updated Transcoder"
    Example: "My Updated Transcoder"

  - `transcoder.protocol` (string)
    The transport protocol for the source video. The default is rtmp.

Example: "protocol": "webrtc"
    Enum: "file", "rtmp", "rtsp", "srt", "udp", "webrtc"

  - `transcoder.broadcast_location` (string)
    The location where Wowza Video transcodes your stream. Choose a location as close as possible to your video source.

You cannot change the broadcast location after initial creation if you are using autostart functionality on your transcoder.

Example: "broadcast_location": "us_central_iowa"
    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"

  - `transcoder.buffer_size` (integer)
    The size, in milliseconds, of the incoming buffer. 0 means no buffer. The default is 4000 (4 seconds).

Example: "buffer_size": 4000
    Enum: 0, 1000, 2000, 3000, 4000, 5000, 6000, 7000, 8000

  - `transcoder.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"

  - `transcoder.delivery_protocols` (array)
    An array of playback protocols enabled for this transcoder. By default, rtmp, rtsp, webrtc, and wowz are returned.

Example: See response body sample

  - `transcoder.description` (string)
    An optional description of the transcoder.

Example: "description": "This transcoder runs our 24/7 stream."
    Example: "My Transcoder Description"

  - `transcoder.disable_authentication` (boolean)
    Authentication is required by default for RTMP and RTSP push connections from a video source to the transcoder. Specify true to disable authentication with the video source.

Example: "disable_authentication": false

  - `transcoder.idle_timeout` (integer)
    The amount of idle time, in seconds, before the transcoder automatically shuts down. Valid values are the integers 0 (never shuts down) to 172800 (48 hours). The default is 1200 (20 minutes).

Example: "idle_timeout": 1600

  - `transcoder.low_latency` (boolean)
    If true, turns off the sort packet buffer and speeds the time it takes to decode and deliver video data to the player. The default is false.

Example: "low_latency": false

  - `transcoder.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

  - `transcoder.play_maximum_connections` (integer)
    The number of users who are allowed to connect directly to the transcoder. The minimum and default value is 10. The maximum number of connections varies by the size of the transcoder, with the maximum value for the largest transcoder being 300 viewers.

Example: "play_maximum_connections": 30

  - `transcoder.properties` (array)
    An array of properties 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.

Available from version 1.5.

Example: See response body sample

  - `transcoder.properties.key` (string, required)
    The key of the property.

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

Section | Valid keys for the section
----------------|-------------
asset_management | enabled Note: You need a Wowza Video subscription to access Asset Management.
cupertino | aes128Hostaes128Secret
ezdrm | usernamepasswordfairPlayAssetIdwideVineContentId
file | repeatstart_streaming_at
output | fitModerecord
recording | mp4
rtmp | allowDirectPlayback
rtsp | avSyncMethoddebugRtspSessionmaxRtcpWaitTime rtpDePacketizerPacketSorterBufferTimertpDePacketizerPacketSorterFlushTimertpDePacketizerWrapperrtpIgnoreSpropParameterSetsrtpIgnoreProfileLevelIdrtpTransportModertspValidationFrequencyrtspFilterUnknownTracks
srt | passPhrase
vod_stream | hlslive2vodNote: VOD streams require a Fastly stream target with HLS as a delivery protocol.

  - `transcoder.properties.section` (string, required)
    The section of the transcoder configuration table that contains the property.
    Enum: "asset_management", "cupertino", "ezdrm", "file", "output", "recording", "rtmp", "rtsp", "srt", "vod_stream"

  - `transcoder.properties.value` (string, required)
    The value of the property.

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

Key(s) | Values for the key
----------------|-------------
aes128Host | Specify the URL that devices will use to fetch the key to decrypt the stream.
aes128Secret | Specify 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.
enabled | Specify true or false. Used in the asset_mangement section.
fitMode | Use letterbox, fit-width, fit-height, crop, stretch, or match-source. The default is fit-height.
maxRtcpWaitTime | Use a whole number, expressed as a string or an integer. The default is 2000 (ms).
passPhrase | Use a string between 10-79 characters in length. It adds security to a live stream for an incoming SRT stream from your device or encoder to Wowza Video. The password protection secures the data payload of SRT live streams, ensuring that the transmitted content is encrypted and safeguarded against unauthorized interception during its journey across the network.
record | Use an output ID associated with the transcoder.
rtpDePacketizerPacketSorterBufferTime | Use an integer, expressed as a string or an integer. The default is 500 (ms).
rtpDePacketizerPacketSorterFlushTime | Use an integer, expressed as a string or an integer. The default is 10 (ms).
rtpDePacketizerWrapper | Use the string RTPDePacketizerWrapperPacketSorter.
rtpTransportMode | Use the string udp or interleave (the default).
rtspValidationFrequency | Use a whole number, expressed as a string or an integer. The default is 15000 (ms).
start_streaming_at | Specify 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.
usernamepasswordfairplayAssetIdwideVineContentId | Use account information and asset IDs from EZDRM. All strings.
avSyncMethoddebugRtspSessionmp4repeatrtspFilterUnknownTracksrtpIgnoreSpropParameterSetsrtpIgnoreProfileLevelId | Use true or false, expressed as a string or a Boolean.
hlslive2vod | 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.

  - `transcoder.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"

  - `transcoder.remove_watermark_image` (boolean)
    If true, removes the watermark from the output. The default is false.

Example: "remove_watermark_image": true

  - `transcoder.source_url` (string)
    For the delivery_method pull or protocol file.

For pull, enter the source's web address without the protocol or the trailing slash (/).

For file, enter the source file URL, including the protocol (http, https, gs, s3).


Example: "source_url": "xyz.streamlock.net/vod/mp4:Movie.mov"

  - `transcoder.stream_extension` (string)
    For the delivery_method push. Some encoders append an extension to their stream names. If the device you're using does this, enter the extension as a period (.) followed by alphanumeric characters.

Example: "stream_extension": ".sdp"

  - `transcoder.stream_source_id` (string)
    For the delivery_method cdn. The alphanumeric string that identifies the stream source that you want to use to deliver the stream to the transcoder.

Example: "stream_source_id": "rxHQQpWw"

  - `transcoder.suppress_stream_target_start` (boolean)
    If true, disables stream targets when the transcoder starts. If false (the default), the targets start when the transcoder starts.

Example: "suppress_stream_target_start": false

  - `transcoder.username` (string)
    A username 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"

  - `transcoder.watermark` (boolean)
    Embeds an image into the transcoded stream for copyright protection. Specify true to embed a watermark image.

Example: "watermark": true

  - `transcoder.watermark_height` (integer)
    The height, in pixels, of the watermark image. If blank, Wowza Video uses the original image height.

Example: "watermark_height": 80

  - `transcoder.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]"

  - `transcoder.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

  - `transcoder.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"

  - `transcoder.watermark_width` (integer)
    The width, in pixels, of the watermark image. If blank, Wowza Video uses the original image width.

Example: "watermark_width": 100

## Response 200 fields (application/json):

  - `transcoder` (object, required)
    Example: {"application_name":"app-B8P6K226","billing_mode":"pay_as_you_go","broadcast_location":"us_central_iowa","buffer_size":4000,"closed_caption_type":"cea","created_at":"2020-01-28T17:16:22.098Z","delivery_method":"push","delivery_protocols":["rtmp","rtsp","wowz","webrtc"],"description":"My Transcoder Description","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"}]},"disable_authentication":false,"domain_name":"f92334.entrypoint.video.wowza.com","id":"2lsWj3F9","idle_timeout":1200,"low_latency":false,"name":"My PAYG Transcoder","outputs":[{}],"password":"82e0e971","playback_stream_name":"wxyz6789","play_maximum_connections":20,"properties":[{"key":"fitMode","section":"output","value":"letterbox"},{"key":"rtpIgnoreProfileLevelId","section":"rtsp","value":true}],"protocol":"rtmp","reference_id":"mySystemID_01","source_port":1935,"stream_extension":".sdp","stream_name":"10eb0ed8","suppress_stream_target_start":false,"transcoder_type":"transcoded","updated_at":"2020-01-31T15:46:50.098Z","username":"client2","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}

  - `transcoder.application_name` (string)
    The application name from the pull stream source URL.
    Example: "app-B8P6K226"

  - `transcoder.asset_id` (string)
    Only applies to the transcoder of a live stream 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.

  - `transcoder.billing_mode` (string)
    The billing mode for the transcoder. The default is 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"

  - `transcoder.broadcast_location` (string)
    The location where Wowza Video transcodes 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"

  - `transcoder.buffer_size` (integer)
    The size, in milliseconds, of the incoming buffer. 0 means no buffer. The default is 4000 (4 seconds).
    Enum: 0, 1000, 2000, 3000, 4000, 5000, 6000, 7000, 8000

  - `transcoder.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"

  - `transcoder.created_at` (string)
    The date and time that the transcoder was created.
    Example: "2020-01-28T17:16:22.098Z"

  - `transcoder.delivery_method` (string)
    The type of connection between the source encoder and the transcoder. The default, pull, instructs the transcoder to pull the video from the source. push instructs the source to push the stream to the transcoder. cdn uses a stream source to deliver the stream to the transcoder.
    Enum: "pull", "cdn", "push"

  - `transcoder.delivery_protocols` (array)
    An array of playback protocols enabled for this transcoder. By default, rtmp, rtsp, webrtc, and wowz are returned.
    Example: ["rtmp","rtsp","wowz","webrtc"]

  - `transcoder.description` (string)
    An optional description of the transcoder.
    Example: "My Transcoder Description"

  - `transcoder.direct_playback_urls` (object)
    A list of direct playback URLs for the transcoder'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"}]}

  - `transcoder.direct_playback_urls.delivery_protocol` (array)
    The name of the direct playback protocol.

  - `transcoder.direct_playback_urls.delivery_protocol.name` (string)
    The name of the playback URL: source, default, or the output rendition's resolution.

  - `transcoder.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"

  - `transcoder.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"

  - `transcoder.direct_playback_urls.delivery_protocol.application_name` (string)
    (WebRTC only) The application name for the WebRTC output.

  - `transcoder.direct_playback_urls.delivery_protocol.stream_name` (string)
    (WebRTC only) The stream name for the WebRTC output rendition.

  - `transcoder.disable_authentication` (boolean)
    Authentication is required by default for RTMP and RTSP push connections from a video source to the transcoder. Specify true to disable authentication with the video source.

  - `transcoder.domain_name` (string)
    The domain name from the pull stream source URL.
    Example: "f92334.entrypoint.video.wowza.com"

  - `transcoder.id` (string)
    The unique alphanumeric string that identifies the transcoder.
    Example: "2lsWj3F9"

  - `transcoder.idle_timeout` (integer)
    The amount of idle time, in seconds, before the transcoder automatically shuts down. Valid values are the integers 0 (never shuts down) to 172800 (48 hours). The default is 1200 (20 minutes).
    Example: 1200

  - `transcoder.low_latency` (boolean)
    If true, turns off the sort packet buffer and speeds the time it takes to decode and deliver video data to the player. The default is false.

  - `transcoder.name` (string)
    A descriptive name for the transcoder. Maximum 200 characters.
    Example: "My PAYG Transcoder"

  - `transcoder.outputs` (array)
    Output renditions associated with the transcoder.
    Example: [{}]

  - `transcoder.outputs.aspect_ratio_height` (integer)
    The height, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1080. Combined with aspect_ratio_width, makes up the input resolution.
    Example: 480

  - `transcoder.outputs.aspect_ratio_width` (integer)
    The width, in pixels, of the output rendition. Should correspond to a widescreen or standard aspect ratio and be divisible by 8. The default is 1920. Combined with aspect_ratio_height, makes up the input resolution.
    Example: 848

  - `transcoder.outputs.bitrate_audio` (integer)
    The audio bitrate, in kilobits per second (Kbps). Must be between 1 and 9999. If the audio_codec is opus, the default is 510, otherwise the default is 128.
    Example: 128

  - `transcoder.outputs.bitrate_video` (integer)
    The video bitrate, in kilobits per second (Kbps). Must be between 1 and 10240. The default is 4000.
    Example: 1600

  - `transcoder.outputs.created_at` (string)
    The date and time that the output rendition was created.
    Example: "2020-01-29T17:16:21.964Z"

  - `transcoder.outputs.framerate_reduction` (string)
    Reduce the frame rate of the transcoded output rendition. The default, 0, uses the encoded stream's frame rate without reduction.
    Enum: "0", "1/2", "1/4", "1/25", "1/30", "1/50", "1/60"

  - `transcoder.outputs.h264_profile` (string)
    The encoding method. Specify main for desktop streaming, baseline for playback on mobile devices, or high for HD playback. The default is high.
    Enum: "main", "baseline", "high"

  - `transcoder.outputs.id` (string)
    The unique alphanumeric string that identifies the output rendition.
    Example: "w9vJm3BJ"

  - `transcoder.outputs.type` (string)
    The type of output rendition, be it WebRTC to use with a transcoder that uses WebRTC as the protocol or a normal output rendition.
    Enum: "WebRtcOutput", "Output"

  - `transcoder.outputs.keyframes` (string)
    The interval used to define the compression applied to a group of frames. The default, follow_source, uses the keyframe interval of the source video.
    Enum: "follow_source", "25", "30", "50", "60", "100", "120"

  - `transcoder.outputs.name` (string)
    A descriptive name for the output (generated, not writable).
    Example: "Standard Output: Video (848 x 480) + Audio"

  - `transcoder.outputs.delete_restrictions` (array)
    The reasons why the output cannot be deleted.

  - `transcoder.outputs.output_stream_targets` (array)
    Example: [{}]

  - `transcoder.outputs.output_stream_targets.created_at` (string)
    The date and time that the output stream target was created.

  - `transcoder.outputs.output_stream_targets.id` (string)
    The unique alphanumeric string that identifies the output stream target.
    Example: "4Gp5rF23"

  - `transcoder.outputs.output_stream_targets.stream_target` (object)

  - `transcoder.outputs.output_stream_targets.stream_target.created_at` (string)
    The date and time that the stream target was created.

  - `transcoder.outputs.output_stream_targets.stream_target.id` (string)
    The unique alphanumeric string that identifies the stream target.

  - `transcoder.outputs.output_stream_targets.stream_target.name` (string)
    A descriptive name for the stream target. Maximum 255 characters.

  - `transcoder.outputs.output_stream_targets.stream_target.state` (string)
    The state of the stream target.
    Enum: "activated", "archived"

  - `transcoder.outputs.output_stream_targets.stream_target.type` (string)
    custom is an external, third-party destination and wowza_cdn is a Wowza CDN target.
    Enum: "custom", "wowza_cdn"

  - `transcoder.outputs.output_stream_targets.stream_target.updated_at` (string)
    The date and time that the stream target was updated.

  - `transcoder.outputs.output_stream_targets.stream_target_id` (string)
    The unique alphanumeric string that identifies the stream target.
    Example: "QvvJYJjk"

  - `transcoder.outputs.output_stream_targets.updated_at` (string)
    The date and time that the output stream target was updated.

  - `transcoder.outputs.output_stream_targets.use_stream_target_backup_url` (boolean)
    Specifies whether the output stream target uses the stream target's primary or backup URL.
    Example: true

  - `transcoder.outputs.output_stream_targets.target_state` (string)
    Specifies whether the stream target is enabled or disabled. This parameter displays in the response when the transcoder or live stream associated with the stream target is running and receiving a stream. Enabled means the stream target is enabled and streaming video to its destination. Disabled means the stream target is disabled and is not streaming video to its destination.
    Enum: "enabled", "disabled"

  - `transcoder.outputs.video_codec` (string)
    The codec used to encode the video stream. disabled sends the stream without a video track and passthrough sends the stream without transcoding the video track. Available from version 1.6.
    Enum: "h264", "passthrough", "disabled"

  - `transcoder.outputs.audio_codec` (string)
    The codec used to encode the audio stream. disabled sends the stream without an audio track and passthrough sends the stream without transcoding the audio track. aac is the most commonly compatible audio codec for protocols, while opus is for WebRTC streams. Available from version 1.6.
    Enum: "aac", "opus", "passthrough", "disabled"

  - `transcoder.outputs.transcoder_id` (string)
    The unique alphanumeric string that identifies the transcoder.
    Example: "PblTJm1t"

  - `transcoder.outputs.updated_at` (string)
    The date and time that the output rendition was updated.
    Example: "2020-01-31T13:47:33.964Z"

  - `transcoder.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: "82e0e971"

  - `transcoder.playback_stream_name` (string)
    The stream name used in the direct playback URL.
    Example: "wxyz6789"

  - `transcoder.play_maximum_connections` (integer)
    The number of users who are allowed to connect directly to the transcoder. The minimum and default value is 10. The maximum number of connections varies by the size of the transcoder, with the maximum value for the largest transcoder being 300 viewers.
    Example: 20

  - `transcoder.protocol` (string)
    The transport protocol for the source video. The default is rtmp.
    Enum: "file", "rtmp", "rtsp", "srt", "udp", "webrtc"

  - `transcoder.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"

  - `transcoder.source_port` (integer)
    The port used for RTMP pull connections to Wowza Video.
    Example: 1935

  - `transcoder.source_url` (string)
    For the delivery_method pull or protocol file.

For pull, enter the source's web address without the preceding protocol or the trailing slash (/).

For file, enter the source file URL, including the protocol (http, https, gs, s3).

  - `transcoder.stream_extension` (string)
    For the delivery_method push. Some encoders append an extension to their stream names. If the device you're using does this, enter the extension as a period (.) followed by alphanumeric characters.
    Example: ".sdp"

  - `transcoder.stream_name` (string)
    The stream name from the pull stream source URL.
    Example: "10eb0ed8"

  - `transcoder.stream_source_id` (string)
    For the delivery_method cdn. The alphanumeric string that identifies the stream source that you want to use to deliver the stream to the transcoder.

  - `transcoder.suppress_stream_target_start` (boolean)
    If true, disables stream targets when the transcoder starts. If false (the default), the targets start when the transcoder starts.

  - `transcoder.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"

  - `transcoder.updated_at` (string)
    The date and time that the transcoder was updated.
    Example: "2020-01-31T15:46:50.098Z"

  - `transcoder.username` (string)
    A username 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: "client2"

  - `transcoder.watermark` (boolean)
    Embeds an image into the transcoded stream for copyright protection. Specify true to embed a watermark image.
    Example: true

  - `transcoder.watermark_height` (integer)
    The height, in pixels, of the watermark image. If blank, Wowza Video uses the original image height.
    Example: 80

  - `transcoder.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"

  - `transcoder.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

  - `transcoder.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"

  - `transcoder.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)