Submit for Review
Effectively managing the lifecycle of your app ensures it successfully transitions through the various stages on the OS1 Platform. By leveraging the UpdateAppStates API, developer admins and product admins can manage their apps through the different stages of the application lifecycle.
Endpoint
PUT /developer/apps/versions/{appVersionId}/states
Attributes
Attribute | Description |
action* | Defines the next step in your app's lifecycle. |
Note: The actions such as APPROVE_TECH_REVIEW, APPROVE_INTERNAL_PUBLISH, and APPROVE_MARKETPLACE_PUBLISH_REVIEW require a product admin role. Please contact us for these actions.
Example Request:
The following request submits the app for tech review.
View Updated States
Call GetAppVersionId to view the newly updates states.
To provide clarity on the different stages an app can traverse through the OS1 Platform, we've provided the lifecycle transitions and phases below. This table captures the app states, the actions causing transitions, the resulting next states, and the entity responsible for those actions.
Once developers complete the development of their app, they must submit it for review. The OS1 Platform team assesses the app, ensuring it meets the required standards. After approval, the app undergoes an internal or marketplace publish preview process. Once this stage is successfully navigated, the app is made live, available for customer subscription and usage.
See the table below with the application lifecycle phases and transitions:
Current state of the App | Action | New State | Owner of the Action |
None | Register an App | DEVELOPMENT | Developer or Developer Admin |
DEVELOPMENT | SUBMIT_FOR_TECH_REVIEW | IN_TECH_REVIEW | Developer Admin |
IN_TECH_REVIEW | DECLINE_TECH_REVIEW | DEVELOPMENT | Product Admin |
IN_TECH_REVIEW | WITHDRAW_FROM_TECH_REVIEW | DEVELOPMENT | Developer Admin |
IN_TECH_REVIEW | APPROVE_TECH_REVIEW | READY_TO_PUBLISH | Product Admin |
READY_TO_PUBLISH | SUBMIT_FOR_INTERNAL_PUBLISH_REVIEW | INTERNAL_PUBLISH_REVIEW | Developer Admin |
READY_TO_PUBLISH | SUBMIT_FOR_MARKETPLACE_PUBLISH_REVIEW | MARKETPLACE_PUBLISH_REVIEW | Developer Admin |
INTERNAL_PUBLISH_REVIEW | APPROVE_INTERNAL_PUBLISH | LIVE | Product Admin |
MARKETPLACE_PUBLISH_REVIEW | APPROVE_MARKETPLACE_PUBLISH | LIVE | Product Admin |
Note: The actions such as APPROVE_TECH_REVIEW, APPROVE_INTERNAL_PUBLISH, and APPROVE_MARKETPLACE_PUBLISH_REVIEW require a product admin role. Please contact us for these actions.