---
title: "Configure a property for a stream target"
method: POST
path: "/stream_targets/{stream_target_id}/properties"
tags: ["stream_targets"]
---

# Configure a property for a stream target

`POST /stream_targets/{stream_target_id}/properties`

This operation configures a property for a stream target. The properties available will depend on the *provider* you are using and are noted in the key descriptions below. For example, if you are using the provider **Wowza CDN on Fastly**, look for that in the descriptions.

For a comprehensive resource describing the use of advanced properties, see [Set advanced properties with the Wowza Video REST API](https://www.wowza.com/docs/how-to-set-advanced-properties-by-using-the-wowza-video-rest-api).

## Path parameters

- `stream_target_id` string, required

## Request body

- union
  - StreamTargetPropertyCreateInput
    - `property` StreamTargetProperty, required — A stream target property. The property configuration consists of a key/value pair and the section of the stream target configuration table the key/value pair is stored in.
      - `key` 'acao' | 'chunkSize' | 'convertAMFData' | 'sendSSL' | 'playSSL' | 'playlistSeconds' | 'redundantChunklists' | 'relativePlaylists', required — The key of the property. The following table lists the available property keys. Key | Description ----------------|------------- **acao** | Explicitly specifies the origin that can access the stream. While most streams won't need the origin explicitly set, you might use this property for older players that don't send the Referer header in their stream request. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly **chunkSize** | Defines the duration of the time-based audio and video chunks that Wowza Video delivers to the target. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **convertAMFData** | Determines whether Wowza Video converts incoming AMF data into ID3 tags. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playlistSeconds** | Defines the maximum allowable length of the playlist. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playSSL** | Determines whether Wowza Video sends the stream from the target to the player by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **sendSSL** | Determines whether Wowza Video sends the stream from the transcoder to the target by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **redundantChunklists** | Determines whether Wowza Video creates redundant chunklists within a playlist. If a primary chunklist within a playlist fails, players that support redundancy during playback can switch to the redundant chunklist. <br/><br/> **Note:** Enabling **redundantChunklists** increases playback reliability but doubles egress data usage and associated charges. <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **relativePlaylists** | Allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino
      - `section` 'hls' | 'playlist', required — The section of the stream target configuration table that contains the property. Section | Valid keys for the section ----------------|------------- **hls** | **acao**, **chunkSize**, **convertAMFData**, and **sendSSL** **playlist** | **playSSL**, **playlistSeconds**, **redundantChunklists**, and **relativePlaylists**
      - `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 ----------------|------------- **acao** | Displays as **http://&lt;_origin_&gt;** **chunkSize** | Valid values are the integers **2**, **4**, **6**, **8**, and **10**. **convertAMFData** <br/> **playSSL** <br/> **sendSSL** <br/> **redundantChunklists** <br/> **relativePlaylists** | Valid values are the Booleans **true** and **false**. **playlistSeconds** | Valid values are any integer between **6** and **28800** (8 hours).
  - StreamTargetPropertiesCreateInput
    - `properties` StreamTargetProperty[], required — An array of properties. The property configuration consists of a key/value pair and the section of the stream target configuration table the key/value pair is stored in. You can only set an array of properties on a Fastly or Akamai stream target. Available from version 1.7.
      - `key` 'acao' | 'chunkSize' | 'convertAMFData' | 'sendSSL' | 'playSSL' | 'playlistSeconds' | 'redundantChunklists' | 'relativePlaylists', required — The key of the property. The following table lists the available property keys. Key | Description ----------------|------------- **acao** | Explicitly specifies the origin that can access the stream. While most streams won't need the origin explicitly set, you might use this property for older players that don't send the Referer header in their stream request. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly **chunkSize** | Defines the duration of the time-based audio and video chunks that Wowza Video delivers to the target. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **convertAMFData** | Determines whether Wowza Video converts incoming AMF data into ID3 tags. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playlistSeconds** | Defines the maximum allowable length of the playlist. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playSSL** | Determines whether Wowza Video sends the stream from the target to the player by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **sendSSL** | Determines whether Wowza Video sends the stream from the transcoder to the target by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **redundantChunklists** | Determines whether Wowza Video creates redundant chunklists within a playlist. If a primary chunklist within a playlist fails, players that support redundancy during playback can switch to the redundant chunklist. <br/><br/> **Note:** Enabling **redundantChunklists** increases playback reliability but doubles egress data usage and associated charges. <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **relativePlaylists** | Allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino
      - `section` 'hls' | 'playlist', required — The section of the stream target configuration table that contains the property. Section | Valid keys for the section ----------------|------------- **hls** | **acao**, **chunkSize**, **convertAMFData**, and **sendSSL** **playlist** | **playSSL**, **playlistSeconds**, **redundantChunklists**, and **relativePlaylists**
      - `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 ----------------|------------- **acao** | Displays as **http://&lt;_origin_&gt;** **chunkSize** | Valid values are the integers **2**, **4**, **6**, **8**, and **10**. **convertAMFData** <br/> **playSSL** <br/> **sendSSL** <br/> **redundantChunklists** <br/> **relativePlaylists** | Valid values are the Booleans **true** and **false**. **playlistSeconds** | Valid values are any integer between **6** and **28800** (8 hours).

## Response `200`

Success

- union
  - StreamTargetPropertyCreateInputRepsonse
    - `property` StreamTargetProperty, required — A stream target property. The property configuration consists of a key/value pair and the section of the stream target configuration table the key/value pair is stored in.
      - `key` 'acao' | 'chunkSize' | 'convertAMFData' | 'sendSSL' | 'playSSL' | 'playlistSeconds' | 'redundantChunklists' | 'relativePlaylists', required — The key of the property. The following table lists the available property keys. Key | Description ----------------|------------- **acao** | Explicitly specifies the origin that can access the stream. While most streams won't need the origin explicitly set, you might use this property for older players that don't send the Referer header in their stream request. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly **chunkSize** | Defines the duration of the time-based audio and video chunks that Wowza Video delivers to the target. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **convertAMFData** | Determines whether Wowza Video converts incoming AMF data into ID3 tags. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playlistSeconds** | Defines the maximum allowable length of the playlist. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playSSL** | Determines whether Wowza Video sends the stream from the target to the player by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **sendSSL** | Determines whether Wowza Video sends the stream from the transcoder to the target by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **redundantChunklists** | Determines whether Wowza Video creates redundant chunklists within a playlist. If a primary chunklist within a playlist fails, players that support redundancy during playback can switch to the redundant chunklist. <br/><br/> **Note:** Enabling **redundantChunklists** increases playback reliability but doubles egress data usage and associated charges. <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **relativePlaylists** | Allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino
      - `section` 'hls' | 'playlist', required — The section of the stream target configuration table that contains the property. Section | Valid keys for the section ----------------|------------- **hls** | **acao**, **chunkSize**, **convertAMFData**, and **sendSSL** **playlist** | **playSSL**, **playlistSeconds**, **redundantChunklists**, and **relativePlaylists**
      - `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 ----------------|------------- **acao** | Displays as **http://&lt;_origin_&gt;** **chunkSize** | Valid values are the integers **2**, **4**, **6**, **8**, and **10**. **convertAMFData** <br/> **playSSL** <br/> **sendSSL** <br/> **redundantChunklists** <br/> **relativePlaylists** | Valid values are the Booleans **true** and **false**. **playlistSeconds** | Valid values are any integer between **6** and **28800** (8 hours).
  - StreamTargetPropertiesCreateInputResponse
    - `properties` StreamTargetProperty[], required — An array of properties. The property configuration consists of a key/value pair and the section of the stream target configuration table the key/value pair is stored in. You can only set an array of properties on a Fastly or Akamai stream target. Available from version 1.7.
      - `key` 'acao' | 'chunkSize' | 'convertAMFData' | 'sendSSL' | 'playSSL' | 'playlistSeconds' | 'redundantChunklists' | 'relativePlaylists', required — The key of the property. The following table lists the available property keys. Key | Description ----------------|------------- **acao** | Explicitly specifies the origin that can access the stream. While most streams won't need the origin explicitly set, you might use this property for older players that don't send the Referer header in their stream request. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly **chunkSize** | Defines the duration of the time-based audio and video chunks that Wowza Video delivers to the target. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **convertAMFData** | Determines whether Wowza Video converts incoming AMF data into ID3 tags. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playlistSeconds** | Defines the maximum allowable length of the playlist. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino **playSSL** | Determines whether Wowza Video sends the stream from the target to the player by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **sendSSL** | Determines whether Wowza Video sends the stream from the transcoder to the target by using SSL (HTTPS). <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **redundantChunklists** | Determines whether Wowza Video creates redundant chunklists within a playlist. If a primary chunklist within a playlist fails, players that support redundancy during playback can switch to the redundant chunklist. <br/><br/> **Note:** Enabling **redundantChunklists** increases playback reliability but doubles egress data usage and associated charges. <br/><br/>**Available on these targets types:** Custom: akamai_cupertino **relativePlaylists** | Allows the viewer to watch the stream over HTTP and HTTPS, whichever protocol their browser calls. <br/><br/>**Available on these targets types:** Wowza CDN on Fastly, Custom: akamai_cupertino
      - `section` 'hls' | 'playlist', required — The section of the stream target configuration table that contains the property. Section | Valid keys for the section ----------------|------------- **hls** | **acao**, **chunkSize**, **convertAMFData**, and **sendSSL** **playlist** | **playSSL**, **playlistSeconds**, **redundantChunklists**, and **relativePlaylists**
      - `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 ----------------|------------- **acao** | Displays as **http://&lt;_origin_&gt;** **chunkSize** | Valid values are the integers **2**, **4**, **6**, **8**, and **10**. **convertAMFData** <br/> **playSSL** <br/> **sendSSL** <br/> **redundantChunklists** <br/> **relativePlaylists** | Valid values are the Booleans **true** and **false**. **playlistSeconds** | Valid values are any integer between **6** and **28800** (8 hours).

## Other responses

- `401` — Unauthorized
- `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)