Skip to main content
POST
/
api
/
apps
/
beta
/
apps
/
{appId}
/
versions
Create App Version
curl --request POST \
  --url https://api.example.com/api/apps/beta/apps/{appId}/versions \
  --header 'Content-Type: application/json' \
  --header 'X-Domino-Api-Key: <api-key>' \
  --data '
{
  "bundleId": "<string>",
  "dataPlaneId": "<string>",
  "description": "<string>",
  "dfsCommitId": "<string>",
  "entryScript": "<string>",
  "environmentId": "<string>",
  "environmentRevisionId": "<string>",
  "extendedIdentityPropagationToAppsEnabled": false,
  "externalVolumeMountIds": [
    "<string>"
  ],
  "hardwareTierId": "<string>",
  "netAppVolumeIds": [
    "<string>"
  ],
  "resolvedDfsCommitId": "<string>",
  "resolvedGitCommitId": "<string>",
  "resolvedImportedGitRepos": [
    {
      "ref": "<string>",
      "repoId": "<string>",
      "repoName": "<string>"
    }
  ],
  "resolvedImportedProjects": [
    {
      "commitId": "<string>",
      "directoryName": "<string>",
      "ownerId": "<string>",
      "projectId": "<string>",
      "projectName": "<string>",
      "release": "<string>"
    }
  ],
  "tags": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "vanityUrl": "<string>"
}
'
{
  "createdAt": 123,
  "environmentId": "<string>",
  "environmentRevisionId": "<string>",
  "extendedIdentityPropagationToAppsEnabled": true,
  "externalVolumeMountIds": [
    "<string>"
  ],
  "hardwareTierId": "<string>",
  "id": "<string>",
  "netAppVolumeIds": [
    "<string>"
  ],
  "tags": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "updatedAt": 123,
  "autoscalingSpecification": {
    "enabled": true,
    "maxReplicas": 15,
    "minReplicas": 15,
    "scaleDownStabilizationWindowSeconds": 1800,
    "scaleUpStabilizationWindowSeconds": 1800,
    "targetCpuAvgUtilizationPct": 50,
    "targetMemoryAvgUtilizationPct": 50,
    "useSessionAffinity": true
  },
  "bundleId": "<string>",
  "bundleName": "<string>",
  "currentInstance": {
    "createdAt": 123,
    "id": "<string>",
    "status": "<string>",
    "describeUrl": "<string>",
    "dfsCommitId": "<string>",
    "gitCommitId": "<string>"
  },
  "description": "<string>",
  "dfsCommitId": "<string>",
  "entryScript": "<string>",
  "gitRef": {
    "value": "<string>"
  },
  "publisher": {
    "id": "<string>",
    "name": "<string>"
  },
  "resolvedCommits": {
    "dfsCommitId": "<string>",
    "gitCommitId": "<string>",
    "importedGitRepos": [
      {
        "ref": "<string>",
        "repoId": "<string>",
        "repoName": "<string>"
      }
    ],
    "importedProjects": [
      {
        "commitId": "<string>",
        "directoryName": "<string>",
        "ownerId": "<string>",
        "projectId": "<string>",
        "projectName": "<string>",
        "release": "<string>"
      }
    ]
  },
  "vanityUrl": "<string>",
  "versionNumber": 123
}

Authorizations

​
X-Domino-Api-Key
string
header
required

Path Parameters

​
appId
string
required

The id of the app to create the version for.

Body

application/json

Request to create an app version

​
autoscalingSpecification
object
​
bundleId
string

Guardrails bundle ID. Immutable after creation; cannot be changed via update.

​
dataPlaneId
string

Target data plane ID. If omitted but hardwareTierId is provided, auto-populated from the hardware tier's data plane. Returns 422 if both are provided and they don't match.

​
description
string

Optional version description.

​
dfsCommitId
string
​
entryScript
string

Optional inline script to execute instead of the app's entry point. If provided, this script will take precedence over the entry point.

​
environmentId
string
​
environmentRevisionId
string
​
extendedIdentityPropagationToAppsEnabled
boolean
default:false
​
externalVolumeMountIds
string[]
​
gitRef
object
​
hardwareTierId
string
​
netAppVolumeIds
string[]
​
resolvedDfsCommitId
string

Pre-resolved DFS commit ID. If provided, used for version comparison instead of resolving from dfsCommitId.

​
resolvedGitCommitId
string

Pre-resolved git commit SHA. If provided, used for version comparison instead of resolving from gitRef.

​
resolvedImportedGitRepos
object[]

Pre-resolved imported git repo snapshots. If provided, used for version comparison.

​
resolvedImportedProjects
object[]

Pre-resolved imported project snapshots. If provided, used for version comparison.

​
tags
object[]
​
vanityUrl
string

Response

Success

​
createdAt
number<epoch>
required
​
environmentId
string
required
​
environmentRevisionId
string
required
​
extendedIdentityPropagationToAppsEnabled
boolean
required
​
externalVolumeMountIds
string[]
required
​
hardwareTierId
string
required
​
id
string
required
​
netAppVolumeIds
string[]
required
​
tags
object[]
required
​
updatedAt
number<epoch>
required
​
autoscalingSpecification
object
​
bundleId
string

Guardrails bundle ID. Immutable after creation.

​
bundleName
string
​
currentInstance
object
​
description
string

Optional version description.

​
dfsCommitId
string

The original DFS commit ID specified when the version was created. May be null if not explicitly provided.

​
entryScript
string

Optional inline script to execute instead of the app's entry point. If provided, this script will take precedence over the entry point.

​
gitRef
object

The original git reference (e.g. branch name) specified when the version was created.

​
publisher
object
​
resolvedCommits
object

Commit and import snapshots resolved at version creation time, representing the actual values used for execution.

​
vanityUrl
string
​
versionNumber
integer<int64>