Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wowza stream_targets API

Operations related to stream targets. A stream target is a destination for a stream. Stream targets can be Wowza Video edge resources; custom, external destinations, target destinations. ### Wowza CDN Stream Targets Wowza CDN stream targets distribute streams to players. When you create a live stream in the API, a Wowza CDN stream target is created automatically. In contrast, you can use ``/stream_targets/wowza_cdn`` endpoints to manually create Wowza CDN stream targets and associate them with transcoders. With Wowza CDN stream targets, you can use geo-blocking to control locations where your stream can be viewed, and you can use token authentication to restrict access to streams. Advanced configuration properties are available for Wowza CDN stream targets. ### Custom Stream Targets Custom stream targets connect to external CDNs to deliver streams to viewers. You manually create custom stream targets and associate them to a transcoder.

Wowza stream_targets API is one of 48 APIs that Wowza publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include stream_targets. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a getting-started guide, and a changelog.

This API exposes 17 operations across 9 paths, and defines 30 schemas. It is described by OpenAPI 3.0.3, at version 2.0.0.

Requests are made against a single base URL, http://localhost:8087.

17 operations 9 paths 30 schemas 3 DELETE8 GET2 PATCH3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0.0
Base URL
https://api.video.wowza.com/api/v2.0
Authentication
HTTP Basic, HTTP Digest
Resource Areas
1

Authentication & Security 2

Wowza stream_targets API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). It uses HTTP digest authentication (digestAuth). By default, every request must be authenticated.

  • basicAuth — HTTP Basic Authentication using Wowza Streaming Engine admin credentials
  • digestAuth — HTTP Digest Authentication

Paths & Operations 17

Across 9 paths, the API surfaces 17 operations — 3 DELETE, 8 GET, 2 PATCH, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

stream_targets 17

Operations related to stream targets. A stream target is a destination for a stream. Stream targets can be Wowza Video edge resources; custom, external destinations, target destin…

GET
/stream_targets
Fetch all stream targets
listStreamTargets 4 params → 200401
GET
/stream_targets/{id}
Fetch a stream target
showStreamTarget 1 param → 200401403404410
POST
/stream_targets/custom
Create a custom stream target
createCustomStreamTarget body → 201401422
GET
/stream_targets/custom
Fetch all custom stream targets
listCustomStreamTargets 2 params → 200401
GET
/stream_targets/custom/{id}
Fetch a custom stream target
showCustomStreamTarget 1 param → 200401403404410
PATCH
/stream_targets/custom/{id}
Update a custom stream target
updateCustomStreamTarget 1 param body → 200401403404410422
DELETE
/stream_targets/custom/{id}
Delete a custom stream target
deleteCustomStreamTarget 2 params → 204401403404410422
POST
/stream_targets/wowza_cdn
Create a Wowza CDN stream target
createFastlyStreamTarget body → 201401422
GET
/stream_targets/wowza_cdn
Fetch all Wowza CDN stream targets
listFastlyStreamTargets 2 params → 200401
GET
/stream_targets/wowza_cdn/{id}
Fetch a Wowza CDN stream target
showFastlyStreamTarget 1 param → 200401403404410
PATCH
/stream_targets/wowza_cdn/{id}
Update a Wowza CDN stream target
updateFastlyStreamTarget 1 param body → 200401403404410422
DELETE
/stream_targets/wowza_cdn/{id}
Delete a Wowza CDN stream target
deleteFastlyStreamTarget 2 params → 204401403404410422
PUT
/stream_targets/{id}/regenerate_connection_code
Regenerate the connection code for any stream target
regenerateConnectionCodeStreamTarget 1 param → 200401403404410422
POST
/stream_targets/{stream_target_id}/properties
Configure a property for a stream target
createStreamTargetProperty 1 param body → 200401422
GET
/stream_targets/{stream_target_id}/properties
Fetch all properties of a stream target
listStreamTargetProperties 1 param → 200401422
GET
/stream_targets/{stream_target_id}/properties/{id}
Fetch a property of a stream target
showStreamTargetProperty 2 params → 200401403404410
DELETE
/stream_targets/{stream_target_id}/properties/{id}
Delete a stream target property
deleteStreamTargetProperty 2 params → 204401403404410422

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are stream_target_fastly (24 properties), fastly_stream_target_patch_response (24 properties), stream_target_custom (12 properties), stream_target_facebook (12 properties). Each schema is shown below with its type and property counts.

stream_target_properties_create_input_response
object
1 property 1 required
custom_stream_target_create_input
fastly_stream_target_update_input
object
1 property 1 required
fastly_stream_target_input
object
1 property 1 required
fastly_stream_target_patch_response
object
24 properties
stream_target_facebook
object
12 properties
stream_target_linkedin
object
11 properties
stream_target_property_create_input
object
1 property 1 required
stream_target_custom
object
12 properties
stream_target_property
object
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 i…
3 properties 3 required
Error401
object
1 property 1 required
fastly_stream_target_create_input
index_custom_stream_target
object
4 properties
stream_target_properties
object
1 property 1 required
stream_targets
object
1 property 1 required
stream_target_properties_create_input
object
1 property 1 required
custom_stream_target_patch_response
object
12 properties
stream_targets_fastly
object
1 property 1 required
stream_target_fastly
object
24 properties
index_stream_target
object
6 properties
stream_target_property_create_input_repsonse
object
1 property 1 required
Error403
object
1 property 1 required
custom_stream_target_input
object
1 property 1 required
stream_target_property_fastly
object
3 properties 3 required
index_fastly_stream_target
object
4 properties
Error422
object
1 property 1 required
stream_targets_custom
object
1 property 1 required
Error410
object
1 property 1 required
custom_stream_target_update_input
object
1 property 1 required
Error404
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wowza-stream-targets-api-openapi.yml Raw ↑

Other APIs Wowza publishes across the network.

Wowza Streaming Engine Java API
Wowza Flowplayer
Wowza GoCoder SDK
Wowza Real-Time Streaming SDK
Wowza advanced_token_authentication API
Wowza analytics_engagement API
Wowza analytics_ingest API
Wowza analytics_popularity API
Wowza analytics_viewers API
Wowza Applications API
Wowza assets API
Wowza categories API