# Create an output stream target

This operation creates an output stream target, assigning the stream target to the specified output rendition.

Endpoint: POST /transcoders/{transcoder_id}/outputs/{output_id}/output_stream_targets
Version: v2.0

## Path parameters:

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

  - `output_id` (string, required)
    The unique alphanumeric string that identifies the output rendition.

## Request fields (application/json):

  - `output_stream_target` (object, required)

  - `output_stream_target.stream_target_id` (string, required)
    The unique alphanumeric string that identifies the stream target.
    Example: "1234abcd"

  - `output_stream_target.use_stream_target_backup_url` (boolean)
    Specifies whether the output stream target uses the stream target's primary or backup URL.

When both the primary and backup URLs are used, Wowza Video sends the stream to both URLs, allowing a provider or 3rd party CDN to improve reliability and prevent playback disruption. If you want to use both URLs, make sure you add the stream target to the output rendition twice, once with use_stream_target_backup_url as false (the default) and once with use_stream_target_backup_url as true.

Example: "use_stream_target_backup_url": true
    Example: true

## Response 201 fields (application/json):

  - `output_stream_target` (object, required)
    Example: {"id":"4Gp5rF23","stream_target_id":"QvvJYJjk","use_stream_target_backup_url":true,"stream_target":{"id":"QvvJYJjk","name":"My provisioned RTMP Stream Target","type":"wowza","created_at":"2020-01-29T17:16:21.965Z","updated_at":"2020-01-31T04:06:40.965Z"},"target_state":"Enabled"}

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

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

  - `output_stream_target.stream_target` (object)

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

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

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

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

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

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

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

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

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

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

## 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 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)