The Wowza Video REST API is periodically versioned. Minor updates
are iterated using sequential dot numbers; major versions are iterated using
sequential whole numbers. For details, see Wowza Video REST API lifecycle management.
Each version is one of these types:
- Beta: The beta version contains everything that's in the current version as well as some features and functionality that are still in development. These work-in-progress features aren't fully tested and are subject to change. When we're done testing, we'll promote the beta version to the current version and then create a new beta with new features. You're free to use the beta version for testing and evaluation, but beta versions aren't intended for use in production environments and we caution against using a beta in production. There is only one beta version available at any time.
- Current: The current version offers the most complete, up-to-date, tested, and stable code base. We strongly recommend using the current version in your production environment. There is only one current version available at any time.
- Supported 1: The first supported version was current at one time but has been replaced by a newer version of the API. This version doesn't have the newest features, and may contain features or functions that are outdated and don't offer the most efficient methods for accomplishing your streaming goals. If you're using this version, we recommend that you upgrade to the current version, as soon as possible.
- Supported 2: The second supported version is no longer part of our active code base and the functionality is frozen. This version is offered as a convenience as you plan and execute your migration to the current version.
- Deprecated: A deprecated version isn't guaranteed to work in production environments. While the paths to the endpoints remain operable, the calls are re-routed to the Supported 2 endpoints. Because of this, if there are compatibility differences between Deprecated and Supported 2, you'll receive error responses on those requests. Also, all relevant documentation is no longer accessible. If you're using a deprecated version, update to the current version immediately.
- Discontinued: A discontinued version is no longer accessible. This stage was formerly known as Sunset.
Query for version status
You can use the following GET request to fetch the current status for
versions of the REST API.
curl -X GET \
-H "Authorization: Bearer ${WV_JWT}" \
'https://api.video.wowza.com/api/versions'
The response should look something like this, but it will differ according
to current version status. Note that the beta version is not included in the
response.
{
"1.10": {
"status": "current",
"base_uri": "/api/v1.10"
},
"1.9": {
"status": "supported",
"base_uri": "/api/v1.9"
}
...
}