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 live_streams API

Operations related to live streams. A live stream is a single, linear video broadcast. You broadcast a live stream by receiving encoded source video into the Wowza Video service and letting Wowza Video transcode the stream and deliver it to viewers. A live stream is essentially a one-stop method for creating a transcoder, output renditions, stream targets, and associated players.

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

Tagged areas include live_streams. 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 11 operations across 8 paths, and defines 17 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.

11 operations 8 paths 17 schemas 1 DELETE4 GET1 PATCH1 POST4 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 live_streams 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 11

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

live_streams 11

Operations related to live streams. A live stream is a single, linear video broadcast. You broadcast a live stream by receiving encoded source video into the Wowza Video service a…

POST
/live_streams
Create a live stream
createLiveStream body → 201401422
GET
/live_streams
Fetch all live streams
listLiveStreams 3 params → 200401
GET
/live_streams/{id}
Fetch a live stream
showLiveStream 1 param → 200401403404410
PATCH
/live_streams/{id}
Update a live stream
updateLiveStream 1 param body → 200401403404410422
DELETE
/live_streams/{id}
Delete a live stream
deleteLiveStream 1 param → 204401403404410422
PUT
/live_streams/{id}/start
Start a live stream
startLiveStream 1 param → 200401403404410422
PUT
/live_streams/{id}/stop
Stop a live stream
stopLiveStream 1 param → 200401403404410422
PUT
/live_streams/{id}/reset
Reset a live stream
resetLiveStream 1 param → 200401403404410422
PUT
/live_streams/{id}/regenerate_connection_code
Regenerate the connection code for a live stream
regenerateConnectionCodeLiveStream 1 param → 200401403404410422
GET
/live_streams/{id}/thumbnail_url
Fetch the thumbnail URL of a live stream
showLiveStreamThumbnailUrl 1 param → 200401403404410
GET
/live_streams/{id}/state
Fetch the state of a live stream
showLiveStreamState 1 param → 200401403404410

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are live_stream (51 properties), player_response_object (13 properties), player_request_object (12 properties), player_request_object_create (10 properties). Each schema is shown below with its type and property counts.

live_stream_update_input
object
1 property 1 required
live_streams
object
1 property 1 required
player_response_object
object
The player object is deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player object will be igno…
13 properties
live_stream_create_input
object
1 property 1 required
live_stream
object
51 properties
broadcast_location
string
The location of your stream. Choose a location as close as possible to your video source.
player_request_object_create
object
The player object is deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player object will be igno…
10 properties
Error401
object
1 property 1 required
hosted_page_response_object
object
Configuration of the hosted page.
6 properties
hosted_page_request_object
object
Configuration of the hosted page.
6 properties
Error403
object
1 property 1 required
index_live_stream
object
5 properties
Error422
object
1 property 1 required
Error410
object
1 property 1 required
player_request_object
object
The player object is deprecated in 2.0. Create and update player configurations in the user interface. Any values you send using the player object will be igno…
12 properties
hosted_page_request_object_create
object
Configuration of the hosted page.
5 properties
Error404
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wowza-live-streams-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