App and Solution
Solutions

Solution Version Management

5min

Overview

Developers can create a new version of their solution using the CreateSolutionVersion API by providing the new version of the solution. This section walks through the process of creating new solution versions to delete development versions on the OS1 platform.

Here’s how the OS1 platform manages versions:

Versions

We support up to 2 development versions:

  1. The first version is in the development state, which means it is actively being worked on by developers.
  2. The second version is at the READY TO PUBLISH state, having been tech review approved but not yet published. This approach is designed so that developers can continue their new development work while the QA team validates the ready to publish version in preparation for publication.

LIVE VERSIONS

The OS1 platform accommodates up to 2 LIVE versions. This setup is strategic, allowing for a phased rollout of new versions.

1. Creating a New Version

NOTE

To create a new version, an existing version should be at least in the READY TO PUBLISH state. See the Submit for Review guide for more details on how to move the app to the READY TO PUBLISH state.



Purpose:

Create a new version for an existing solution using the metadata from the previous version.

Endpoint

POST /developer/solutions/{solutionId}/versions

Attributes

Attribute

Description

version*

The new version of the app.

parentVersion

The base version from which the new version has to be created. If the parent version is not provided then the latest READY TO PUBLISH version will used as a base version.



Example Request

The following shows an example CreateSolutionVersion request. The request creates version 2.0.0 for a solution.  

Example Request


Response:

Upon successful execution, the API will return details of the new version, including the GUID for the newly created version.

2. Deleting a Development Version

Purpose:

Deletes a solution version currently in the development phase.

Note: A version in any state after DEVELOPMENT cannot be deleted.

Endpoint

Response:

When successful, the API will return a 200 response code, indicating the version was deleted successfully.

Note: Ensure the version you're trying to delete is in the 'Development' state. Deleting versions in any other state will trigger an error response.