VOD Streams

Operations related to video on demand (VOD) streams, which are created through the /live_streams or /transcoders resources. A VOD stream is a recording of a live stream that viewers can replay at a later date. After the broadcast is over and the live stream or transcoder is stopped, Wowza Video creates the VOD stream and generates a playback URL. See About VOD Streams to learn more.

Fetch all VOD streams

(Available from version 1.5) This operation shows limited details for VOD streams. For detailed information, fetch a single VOD stream.

Request

query Parameters

filter	string Restricts the data that gets returned by filtering on one or more values associated with a field. Construct a filter using a two-part expression that specifies the field on which to filter and the logic to use to filter. Filters use a zero-based index. For valid filter operators and filter fields, see How to get filtered query results with the Wowza Video REST API. Example: filter[0][field]=state&filter[0][eq]=stopped
page	integer Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. For more information and examples, see Get paginated query results with the Wowza Video REST API.
per_page	integer For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000.

Responses

200

Success

Response Schema: application/json

required

Array of objects (vod_streams)

Array

id	string The unique alphanumeric string that identifies the VOD stream.
name	string A descriptive name for the VOD stream. Maximum 200 characters.
state	string The state of the VOD stream. Enum: "processing" "completed" "failed"
playback_enabled	boolean Specifies whether playback is enabled for the VOD stream. Enum: true false
created_at	string The date and time that the VOD stream was created.
updated_at	string The date and time that the VOD stream was updated.

401

Unauthorized

get/vod_streams

Request samples

Shell
JavaScript
Java
Python

// Using cURL
curl -H "Authorization: Bearer ${WV_JWT}" \
  
  -H "Content-Type: application/json" \
  -X "GET" \
  "${WV_HOST}/api/v1.10/vod_streams

Response samples

application/json

{"vod_streams": [{"id": "wdjfqvsv",
"name": "My VOD Stream 1",
"state": "failed",
"playback_enabled": false,
"created_at": "2020-02-25T17:16:25.849Z",
"updated_at": "2020-01-28T16:06:47.849Z"
},
{"id": "XyxZKqHO",
"name": "My VOD Stream 2",
"state": "completed",
"playback_enabled": true,
"created_at": "2020-01-29T17:16:21.849Z",
"updated_at": "2020-01-31T02:26:05.849Z"
},
{"id": "Pz21DRSt",
"name": "My VOD Stream 3",
"state": "completed",
"playback_enabled": true,
"created_at": "2020-01-29T17:16:21.849Z",
"updated_at": "2020-01-30T18:13:18.849Z"
}
]
}

Fetch a VOD stream

(Available from version 1.5) This operation shows the details of a specific VOD stream.

Request

path Parameters

required

string

The unique alphanumeric string that identifies the VOD stream.

Responses

200

Success

Response Schema: application/json

required

object (vod_stream)

asset_id	string Only applies to VOD streams created for Asset Management. The id for the asset associated with your VOD stream. You can manage your asset in Asset Management.
created_at	string <date-time> The date and time that the VOD stream was created.
duration	integer The duration of the VOD stream.
end_segment	integer The media sequence number of the last media segment in the chunklist.
id	string The unique alphanumeric string that identifies the VOD stream.
name	string A descriptive name for the VOD stream. Maximum 200 characters.
percent_complete	integer The processing progress of the VOD stream.
playback_enabled	boolean Specifies whether playback is enabled for the VOD stream. Enum: true false
playback_url	string The address that can be used to configure playback of the VOD stream.
size	integer The size of the VOD stream.
started_at	string <date-time> The date and time that the stream was started.
start_segment	integer The media sequence number of the first media segment in the chunklist.
state	string The state of the VOD stream. Enum: "processing" "completed" "failed"
stream_target_id	integer The unique alphanumeric string that identifies the stream target associated with the VOD stream.
source	string The source from which the VOD stream was created. The default is live.
type	string The VOD stream type.
updated_at	string <date-time> The date and time that the VOD stream was updated.
uptime_id	string The unique identifier associated with a specific uptime period of a transcoder.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

get/vod_streams/{id}

Request samples

Shell
JavaScript
Java
Python

// Using cURL
curl -H "Authorization: Bearer ${WV_JWT}" \
  
  -H "Content-Type: application/json" \
  -X "GET" \
  "${WV_HOST}/api/v1.10/vod_streams/1kfgc39"

Response samples

application/json

{"vod_stream": {"created_at": "2020-02-12T19:20:46.000Z",
"duration": 480,
"end_segment": 48,
"id": "lmp0vwrd",
"name": "MyVODStream",
"percent_complete": 100,
"playback_enabled": true,
"playback_url": "https://wowzasubdomain/1/RmlPcnpsM0Z1Nzd2/SFhkUXlv/hls/live/playlist.m3u8",
"size": 98154424,
"started_at": "2020-01-21T17:18:05.000Z",
"start_segment": 1,
"state": "completed",
"stream_target_id": "xcslyxf0",
"source": "live",
"type": "Original",
"updated_at": "2020-02-20T06:12:39.956Z",
"uptime_id": "abcd1234"
}
}

Update a VOD stream

(Available from version 1.5) This operation updates a VOD stream.

Request

path Parameters

required

string

The unique alphanumeric string that identifies the VOD stream.

Request Body schema: application/json
required

Provide the details of the VOD stream to update in the body of the request.

required

object (vod_stream)

name required	string A descriptive name for the VOD stream. Maximum 200 characters. Example: `"name": "My updated VOD stream"`
playback_enabled	boolean Specifies whether playback is enabled for the VOD stream. Example: `"playback_enabled": true` Enum: true false

Responses

200

Success

Response Schema: application/json

required

object (vod_stream)

asset_id	string Only applies to VOD streams created for Asset Management. The id for the asset associated with your VOD stream. You can manage your asset in Asset Management.
created_at	string <date-time> The date and time that the VOD stream was created.
duration	integer The duration of the VOD stream.
end_segment	integer The media sequence number of the last media segment in the chunklist.
id	string The unique alphanumeric string that identifies the VOD stream.
name	string A descriptive name for the VOD stream. Maximum 200 characters.
percent_complete	integer The processing progress of the VOD stream.
playback_enabled	boolean Specifies whether playback is enabled for the VOD stream. Enum: true false
playback_url	string The address that can be used to configure playback of the VOD stream.
size	integer The size of the VOD stream.
started_at	string <date-time> The date and time that the stream was started.
start_segment	integer The media sequence number of the first media segment in the chunklist.
state	string The state of the VOD stream. Enum: "processing" "completed" "failed"
stream_target_id	integer The unique alphanumeric string that identifies the stream target associated with the VOD stream.
source	string The source from which the VOD stream was created. The default is live.
type	string The VOD stream type.
updated_at	string <date-time> The date and time that the VOD stream was updated.
uptime_id	string The unique identifier associated with a specific uptime period of a transcoder.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

patch/vod_streams/{id}

Request samples

Payload
Shell
JavaScript
Java
Python

application/json

{"vod_stream": {"name": "My VOD Stream 1",
"playback_enabled": true
}
}

Response samples

application/json

{"vod_stream": {"created_at": "2020-02-12T19:20:46.000Z",
"duration": 480,
"end_segment": 48,
"id": "lmp0vwrd",
"name": "MyVODStream",
"percent_complete": 100,
"playback_enabled": true,
"playback_url": "https://wowzasubdomain/1/RmlPcnpsM0Z1Nzd2/SFhkUXlv/hls/live/playlist.m3u8",
"size": 98154424,
"started_at": "2020-01-21T17:18:05.000Z",
"start_segment": 1,
"state": "completed",
"stream_target_id": "xcslyxf0",
"source": "live",
"type": "Original",
"updated_at": "2020-02-20T06:12:39.956Z",
"uptime_id": "abcd1234"
}
}

Delete a VOD stream

(Available from version 1.5) This operation deletes a VOD stream.

Note: You can't remove VOD streams that have an asset_id. Assets must be removed by sending a DEL request to the /assets endpoint.

Request

path Parameters

required

string

The unique alphanumeric string that identifies the VOD stream.

Responses

204

No Content

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

422

Unprocessable Entity

delete/vod_streams/{id}

Request samples

Shell
JavaScript
Java
Python

// Using cURL
curl -H "Authorization: Bearer ${WV_JWT}" \
  
  -H "Content-Type: application/json" \
  -X "DELETE" \
  "${WV_HOST}/api/v1.10/vod_streams/1kfgc39"

Response samples

application/json

{"Example Response 1": {"meta": {"status": 401,
"code": "ERR-401-NoApiKey",
"title": "No API Key Error",
"message": "No API key sent in header.",
"description": "",
"links": [ ]
}
},
"Example Response 2": {"meta": {"status": 401,
"code": "ERR-401-NoAccessKey",
"title": "No Access Key Error",
"message": "No access key sent in header.",
"description": "",
"links": [ ]
}
},
"Example Response 3": {"meta": {"status": 401,
"code": "ERR-401-InvalidApiKey",
"title": "Invalid Api Key Error",
"message": "Invalid API key.",
"description": "",
"links": [ ]
}
},
"Example Response 4": {"meta": {"status": 401,
"code": "ERR-401-InvalidAccessKey",
"title": "Invalid Access Key Error",
"message": "Invalid access key.",
"description": "",
"links": [ ]
}
},
"Example Response 5": {"meta": {"status": 401,
"code": "ERR-401-BadAccountStatus",
"title": "Bad Account Status Error",
"message": "Your account's status doesn't allow this action.",
"description": "",
"links": [ ]
}
},
"Example Response 6": {"meta": {"status": 401,
"code": "ERR-401-FeatureNotEnabled",
"title": "Feature Not Enabled Error",
"message": "This feature isn't enabled.",
"description": "",
"links": [ ]
}
},
"Example Response 7": {"meta": {"status": 401,
"code": "ERR-401-TrialExceeded",
"title": "Bad Billing Status Error",
"message": "Your billing status needs attention. You can't start or add live streams until your billing status is updated.",
"description": "",
"links": [ ]
}
},
"Example Response 8": {"meta": {"status": 401,
"code": "ERR-401-ExpiredToken",
"title": "JWT is expired",
"message": "Token has exired.",
"description": "",
"links": [ ]
}
},
"Example Response 9": {"meta": {"status": 401,
"code": "ERR-401-InvalidToken",
"title": "JWT is invalid",
"message": "Token is invalid.",
"description": "",
"links": [ ]
}
}
}

VOD Streams

Fetch all VOD streams

query Parameters

Response Schema: application/json

Fetch a VOD stream

path Parameters

Response Schema: application/json

Update a VOD stream

path Parameters

Request Body schema: application/jsonrequired

Response Schema: application/json

Delete a VOD stream

path Parameters

Request Body schema: application/json
required