Add a new version to an application

1min

POST
/developer/apps/{appId}/versions
Adds a new version to an existing application. The new version of the application will be created with the same metadata as the previous version,
or parent version (if defined), of the application except for the version number and the lifecycle phase which gets reset to Development.
Once a new version is created, the appId remains the same but the version id will be different.
Any new app attribute updates should be done using a combination of the appId and a new version id.
RequiredFieldDescription
YESversionSemantic version of the application version that is being added.
NOparentVersionSemantic version of the application version you want to copy from.
Note: The current application version must be in a LIVE state before a new version can be added.
Access: API can be accessed by users who are part of the team which the application belongs to.
Path Parameters
appId
string
*
Header Parameters
x-developerplatform-access
string
*
Body Parameters
body
AddApplicationVersionDTO
*
version
string
*
parentVersion
string
Responses
200
AddApplicationVersionResponseDTO
id
ApplicationVersionIdentifierDTO
*
201
AddApplicationVersionResponseDTO
id
ApplicationVersionIdentifierDTO
*
400
Something is incorrect in the request body.
BadRequestErrorResponseDTO
error
BadRequestErrorDTO
*
request
StandardRequestDTO
*
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 id
NotFoundErrorResponseDTO
error
NotFoundErrorDTO
*
request
StandardRequestDTO
*
Curl
JS
Ruby
Python
curl --location --globoff '/developer/apps/{appId}/versions' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "version": ""
}'
curl --location --globoff '/developer/apps/{appId}/versions' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "version": ""
}'
Responses
200
201
400
403
404
{
  "id": {
    "appId": "app:b31414f1-bc40-42c9-bcc0-ed7a47126441",
    "appVersionId": "appversion:bf17e158-1951-47f9-84f1-e50aeb59fac2"
  }
}
{
  "id": {
    "appId": "app:b31414f1-bc40-42c9-bcc0-ed7a47126441",
    "appVersionId": "appversion:bf17e158-1951-47f9-84f1-e50aeb59fac2"
  }
}
﻿
﻿

Required	Field	Description
YES	version	Semantic version of the application version that is being added.
NO	parentVersion	Semantic version of the application version you want to copy from.

Updated 10 Oct 2024

Did this page help you?

Update the lifecycle of an application version.

Get Solution By Solution ID