Managing Application Versions#

An ApplicationVersion enables you to manage different releases of your applications.

Create an Application Version

To create a new version for an existing application:

Endpoint: POST /cfg/apps/{id}/versions

Path Parameters:

  • id: Application ID

Request Body:

{
"version": "1.2.3-alpha.1",
"container": "nvcr.io/nvidia/omniverse/usd-viewer",
"container_version": "0.2.0",
"helm_chart": "omniverse/kit-appstream-session",
"helm_chart_version": "0.1.0"
}

Response:

{
"version": "1.2.3-alpha.1"
}

Instructions:

  1. The version should follow the semantic versioning format: MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD].

  2. Specify the container and container_version that this application version will use.

  3. Provide the helm_chart and helm_chart_version for deploying this application version.

  4. Ensure that the specified container and Helm chart are accessible and compatible with your application.

Delete an Application Version

To delete a specific version of an application:

Endpoint: DELETE /cfg/apps/{id}/versions

Path Parameters:

  • id: Application ID

Request Body:

{
"version": "1.2.3-alpha.1"
}

Response:

  • Status: 204 No Content

Instructions:

  1. Deleting a version removes the version permanently, and does not impact active streams.

  2. After deletion, you can reuse the version string for a new version, but you should use unique version strings to avoid confusion.