---
title: "Update a custom stream target"
method: PATCH
path: "/stream_targets/custom/{id}"
tags: ["stream_targets"]
---

# Update a custom stream target

`PATCH /stream_targets/custom/{id}`

This operation updates a custom stream target.

## Path parameters

- `id` string, required

## Request body

- CustomStreamTargetUpdateInput
  - `stream_target_custom` object, required
    - `backup_url` string — The backup RTMP ingest URL of the custom stream target. Not all providers or third-party CDNs provide backup URLs. Not for use with the akamai_cupertino custom *provider*. **Note:** 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**. See <a href="https://api.docs.video.wowza.com/index/current/tag/transcoders/#tag/transcoders/operation/createTranscoderOutputOutputStreamTarget">POST /transcoders/[ID]/outputs/[ID]/output_stream_targets</a> for more information. **Example:** <code>"backup_url": "rtmp://b.ep337857.i.akamaientrypoint.net/EntryPoint"</code>
    - `name` string — A descriptive name for the custom stream target. Maximum 255 characters. **Example:** <code>"name": "My Updated Custom Stream Target"</code>
    - `password` string — A *username* must be present. The password associated with the target username for RTMP authentication. Not for use with the akamai_cupertino custom *provider*. **Note:** If you want to clear both username and password for RTMP authentication, send an empty string for both username and password fields. **Example:** <code>"password": "cb1e77e98d"</code>
    - `playback_urls` object — Web addresses that the target uses to play streams. Available from version 1.7. **Example:** See response body sample
      - `hls` string — Web address that the target uses to play HLS streams. <br/><br/> The format is a hash where the key is **hls** and the value is the playback URL. <br/>Example&#58; "hls":&nbsp;"http&#58;//&lt;*domain*&gt;/master.m3u8"
      - `hds` string — Web address that the target uses to play HDS streams. Not for use with the akamai_cupertino custom *provider*. <br/><br/>The format is a hash where the key is **hds** and the value is the playback URL. <br/>Example&#58; "hds":&nbsp;"http&#58;//&lt;*domain*&gt;/manifest.f4m"
      - `rtmp` string — Web address that the target uses to play RTMP streams. <br/><br/>The format is a hash where the key is **rtmp** and the value is the playback URL. <br/>Example&#58; "rtmp":&nbsp;"rtmp&#58;//cp319499.live.edgefcs.net/live/c9467d50@337857"
    - `primary_url` string — The primary RTMP ingest URL. Hostnames can't contain underscores. **Example:** <code>"primary_url": "rtmp://b.ep337857.i.akamaientrypoint.net/EntryPoint"</code>
    - `provider` 'akamai_cupertino' | 'rtmp' | 'rtmps' — The CDN for the target. **Example:** <code>"provider": "akamai_cupertino"</code>
    - `stream_name` string — The name of the stream as defined in the target's ingestion settings. The protocol, host name, and path components of the stream name URL must be 255 characters or less. The query strings and parameter components of the stream name URL must be 1024 characters or less. **Example:** <code>"stream_name": "c8467d50@337857"</code>
    - `username` string — The username or ID that the target uses for RTMP authentication. Not for use with the akamai_cupertino custom *provider*. **Note:** If you want to clear both username and password for RTMP authentication, send an empty string for both username and password fields. **Example:** <code>"username": "319699"</code>

## Response `200`

Success

- object
  - `stream_target_custom` CustomStreamTargetPatchResponse
    - `backup_url` string — The backup ingest URL for a custom stream target. Not for use with the akamai_cupertino custom *provider*.
    - `created_at` string, date-time — The date and time that the custom stream target was created.
    - `delivery_protocols` string[] — An array of the delivery protocols available for this stream target. Available from version 1.7.
    - `id` string — The unique alphanumeric string that identifies the custom stream target.
    - `name` string — A descriptive name for the custom stream target. Maximum 255 characters.
    - `password` string — A *username* must be present. The password associated with the target username for RTMP authentication. Not for use with the akamai_cupertino custom *provider*.
    - `playback_urls` object — Web addresses that the target uses to play streams. Available from version 1.7.
      - `hls` object[] — Web address that the target uses to play HLS streams.
        - `name` string — The name of the playback URL.
        - `url` string — The playback URL.
      - `hds` object[] — Web address that the target uses to play HDS streams. Not for use with the akamai_cupertino custom *provider*.
        - `name` string — The name of the playback URL.
        - `url` string — The playback URL.
      - `rtmp` object[] — Web address that the target uses to play RTMP streams.
        - `name` string — The name of the playback URL.
        - `url` string — The playback URL.
    - `primary_url` string — The primary ingest URL of the custom stream target.
    - `provider` string — The CDN for the target.
    - `stream_name` string — The name of the stream being ingested into the target.
    - `updated_at` string, date-time — The date and time that the custom stream target was updated.
    - `username` string — he username or ID that the target uses for RTMP authentication. Not for use with the akamai_cupertino custom *provider*.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `410` — Gone
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/versions/157b6f741f2a/schema)