Website logo
Docs
API Reference
Postman Collection
Release Notes
Navigate through spaces
⌘K
Overview
API Reference Overview
How to use the API 'Try It' feature
Apps And Solutions
Health
Application
Solution
Common
Authentication
Download OpenAPI file
Authentication And Authorization (AAA) Service
Role Management
User Management
Authentication
Connection Management
Group Management
File Management Service
Folders
Files
SDS Service
App
Vault
Data
Messaging Service
Introduction
Messages
Service Provider Management
Templates Management
Metering
Tenant Config Management
Notification Management
Mobile Push Notifications
App
App Notification
Event
Notification
Dispatch Service
Job Type
Job Workflow
Job
Job - Config
Dispatch Type
Dispatch
Mobile APIs
Dispatch - Config
Ledger
Ledger in batch
Custom Code Config
Participant Service
Tenant
Participant Type
Participant Type - Custom Code Config
Participant Type - Attributes Config
Participant Type - State Machine
Participant
Templates
Participant State
Participant - Batch Processing
Onboard
Container Service
Container Type
Container Type - Custom Code Config
Container Type - Attributes Config
Container Type - State Machine Config
Container
Container State
Container Group
Container - Batch Processing
Workflow Service
Execution Task
Changelog
Execution Macro
Execution Workflow
Execution Workflow Instance
Health Check
State Machine Service
State Machine Config
Entity
Events
Reasons
Instance State
Default Plugins
Job Manager
Work Order Manager
Container Manager
Workflow Manager
Cancellation Manager
Movement Tracking Service
Trace Data
Missing Sequence Numbers
Snapped Distance
Map Service Provider Management
Maps
ETA
Route
IOT Device
Geofence
MTS Subscription
Consent
Track
GPS Integration
MTS Metering
Settings
Events
Nearby Search
Entity Service
Entity Type
State Machine Config
Entity Instance
Entity Type - Custom Code Config
Entity Instance State
Templates
Entity - Batch Processing
Onboard
Location Service
Location
Country
State
City
Search
Order Service
Order Config
Order State Machine Configuration
Order State Machine Transition
Work Order State Machine Configuration
Work Order State Transition
Order
Batch Order
Custom Code Config
Plugin Callback
External Reference APIs
Work Order Config
Work Order Status
Plugins
PluginWorkflow
User FPA
Users
File Upload
Designation
Groups
Config Management
Teams FPA
Teams
Filter API
Facility FPA
Facilities
Vehicle FPA
Vehicles
LogisticsOrder API
Order
Client Order APIs
Batch Order
Callback APIs
Tenant Init
AAA - External Authorizer
Authorization
Orchestrator
Plugins
PluginsV2
PluginWorkflow
Rules
RulesV2
DLQ Service
Query & Listing
Scheduler Service
Scheduler Service
Webhook Service
Apps
Events
Subscriptions
Attribute Alias API
POST
Create type with attribute aliases
PUT
Update type with attribute aliases
GET
Get all attribute aliases
Docs powered by Archbee
Apps And Solutions
Application

Update the lifecycle of an application version.

1min
PUT
/developer/apps/versions/{appVersionId}/states

This API is used to update the lifecycle of an application version.

Application lifecycle phases are the different stages that an application goes through before it is available for customers to subscribe. Application developers need to submit the application for review once they are ready to publish the application. The application is then reviewed by the OS1 platform team and approved for publishing. One the application is approved for publishing, It goes through internal/ marketplace publish preview process in the marketaplce and put in live phase where it can be subscribed to by the customers.

This API can be used to change the lifecycle phase of an application. The following table shows the different lifecycle phases and the actions that can be performed on the application in each phase.

The following rules are enforced:

  • No more than one version can be in dev at a time.
  • No more than one version can be in tech review at a time.
  • Only one live, non-deprecated version can exist at a given time (however deprecated live versions can exist).
CommandPerformed by
SUBMIT_FOR_TECH_REVIEWDeveloper admin
DECLINE_TECH_REVIEWProduct Admin
WITHDRAW_FROM_TECH_REVIEWDeveloper Admin
APPROVE_TECH_REVIEWProduct Admin
SUBMIT_FOR_INTERNAL_PUBLISH_REVIEWDeveloper Admin
SUBMIT_FOR_MARKETPLACE_PUBLISH_REVIEWDeveloper Admin
APPROVE_INTERNAL_PUBLISHProduct Admin
APPROVE_MARKETPLACE_PUBLISHProduct Admin
DEPRECIATEProduct Admin
Path Parameters
appVersionId
string
*
Header Parameters
x-developerplatform-role
string
x-developerplatform-access
string
Body Parameters
body
UpdateLifecycleDto
*
action
string<SUBMIT_FOR_TECH_REVIEW | DECLINE_TECH_REVIEW | WITHDRAW_FROM_TECH_REVIEW | APPROVE_TECH_REVIEW | SUBMIT_FOR_INTERNAL_PUBLISH_REVIEW | SUBMIT_FOR_MARKETPLACE_PUBLISH_REVIEW | APPROVE_INTERNAL_PUBLISH | APPROVE_MARKETPLACE_PUBLISH | DEPRECIATE>
*
Responses
200
EmptyDto
403
User does not have access to the app's org/team combo
ForbiddenErrorResponseDTO
error
ForbiddenErrorDTO
*
request
StandardRequestDTO
*
404
App not found based on provided app version id
NotFoundErrorResponseDTO
error
NotFoundErrorDTO
*
request
StandardRequestDTO
*
Curl
JS
Ruby
Python
1curl --location --globoff --request PUT '/developer/apps/versions/{appVersionId}/states' \ 2--header 'Accept: application/json' \ 3--header 'Content-Type: application/json' \ 4--data '{ 5 "action": "" 6}'
Responses
200
403
404
1{}




Updated 11 Jun 2024
Did this page help you?
PREVIOUS
Get Application Production Credentials
NEXT
Add a new version to an application
Docs powered by Archbee
Docs powered by Archbee