App and Solution
Apps

Submit for Review

4min

Overview

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.

Update the App State

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.

Tech Review


View Updated States

Call GetAppVersionId to view the newly updates states.



Application Lifecycle Phases

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.