Wowza Streaming Cloud REST API lifecycle management

The Wowza Streaming Cloud service naturally evolves over time as we improve the streaming experience. As part of this evolution, we add new features as well as remove functionality that becomes outdated. Our goal is to provide a well-maintained REST API that delivers reliably. To do this, we actively manage the lifecycle of the Wowza Streaming Cloud REST API.

Important: This API lifecycle management process is fully effective March 15, 2022.

Between April 2021 and March 2022, we'll be moving our development processes into alignment with this lifecycle process to deliver version 1.8 of the Wowza Streaming Cloud as the current version on March 15, 2022. 

API lifecycle

Our API lifecycle begins at the Beta stage, and 5 versions of our REST API are available at any given time. To ensure a stable API and minimize disruption to your streaming solutions, we add new features and remove outdated functionality in the Beta version of the API.

Every 6 months, we test and finalize the Beta version and then move all existing API versions along to the next lifecycle stage. Beta moves to Current, Current to Supported 1, and so on. When an API reaches Discontinued, it is removed from production and no longer available.

We recommend that you migrate to the new Current version of the REST API as it becomes available. This ensures you're using the most up-to-date, stable version of the API. As a version cycles through the stages, it becomes increasingly outdated and when it reaches Deprecated, it may no longer function as expected because of our re-routing policy for deprecated versions.

While we strive to maintain backwards compatibility between versions of the API to simplify your migration, it's not always possible when we add significant new functionality or improve architectural features. Staying current with the REST API is an easier migration task than migrating from an API version several stages removed from the current version with more cumulative changes.

Tip: Use automation to alert you when you are no longer using the current version of the REST API. To learn more, see Manage API versions in your code.

To learn more about each stage of our API lifecycle, click See more

Lifecycle schedule

As we bring our development processes into alignment with our lifecycle management process, this table reflects actual delivery dates, anticipated delivery dates, and scheduled delivery dates. 

  • Actual delivery dates are in plain text. These are the dates we delivered in our previous API lifecycle management process. 
  • Anticipated delivery dates are underlined. These are the dates that we plan on moving the API to the next stage, however because we're working to align processes, they could change.    
  • Scheduled delivery dates are bold. We'll have our process alignment complete and will deliver version 1.8 to the current stage on March 15, 2022. March 15, 2022 and later dates are scheduled delivery dates.  

* Dates are in MM/DD/YYYY format.

API Version Beta Current Supported 1 Supported 2 Deprecated Discontinued
1.4 1/31/2019 1/31/2020 5/27/2020 1/5/2021 3/15/2022
1.5 1/31/2020 5/27/2020 12/1/2020 10/15/2021 3/15/2022 9/15/2022
1.6 5/27/2020 12/1/2020 10/15/2021 3/15/2022 9/15/2022 3/15/2023
1.7 12/1/2020 10/15/2021 3/15/2022 9/15/2022 3/15/2023 9/15/2023
1.8 10/15/2021 3/15/2022 9/15/2022 3/15/2023 9/15/2023 3/15/2024

Manage API versions in your code

We recommend that you use the current version of the API, always. Use the Query for version status endpoint to automate notification when there's a new current version of the REST API available, then plan and execute your migration to the new current version.

curl -X GET \

-H 'wsc-api-key: ${WSC_API_KEY}' \

-H 'wsc-access-key: ${WSC_ACCESS_KEY}' \

'https://api.cloud.wowza.com/api/versions'

The sample response looks similar to this, but differs according to current version status. Because current and supported APIs are the only ones intended for production use, those are the only statuses returned in the response.

{
  "1.6": {
    "status": "current",
    "base_uri": "/api/v1.6"
     },
    "1.5": {
        "status": "supported",
        "base_uri": "/api/v1.5"
    }
    ...
}

Consult the Wowza Streaming Cloud REST API migration guide for information about changes between API version as you plan your migration to a new current version of the API. 

More resources