Skip to main content
POST
/
api
/
apps
/
v1
/
apps
/
{appId}
/
versions
Create App Version (v1)
curl --request POST \
  --url https://api.example.com/api/apps/v1/apps/{appId}/versions \
  --header 'Content-Type: application/json' \
  --header 'X-Domino-Api-Key: <api-key>' \
  --data '
{
  "bundleId": "<string>",
  "content": {
    "dataPlaneId": "<string>",
    "dfsCommitId": "<string>",
    "entryScript": "<string>",
    "environmentId": "<string>",
    "environmentRevisionId": "<string>",
    "extendedIdentityPropagationToAppsEnabled": true,
    "externalVolumeMountIds": [
      "<string>"
    ],
    "mountDatasets": true,
    "netAppVolumeIds": [
      "<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>"
        }
      ]
    }
  },
  "deployment": {
    "hardwareTierId": "<string>",
    "renderIFrame": true,
    "vanityUrl": "<string>"
  },
  "description": "<string>",
  "tags": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "workspaceId": "<string>"
}
'
{
  "createdAt": 123,
  "id": "<string>",
  "tags": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "updatedAt": 123,
  "bundle": {
    "id": "<string>",
    "name": "<string>"
  },
  "content": {
    "mountDatasets": true,
    "dataPlaneId": "<string>",
    "dfsCommitId": "<string>",
    "entryScript": "<string>",
    "environmentId": "<string>",
    "environmentRevisionId": "<string>",
    "extendedIdentityPropagationToAppsEnabled": true,
    "externalVolumeMountIds": [
      "<string>"
    ],
    "gitRef": {
      "value": "<string>"
    },
    "netAppVolumeIds": [
      "<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>"
        }
      ]
    }
  },
  "currentInstance": {
    "createdAt": 123,
    "id": "<string>",
    "status": "<string>",
    "describeUrl": "<string>",
    "dfsCommitId": "<string>",
    "gitCommitId": "<string>",
    "publisher": {
      "id": "<string>",
      "name": "<string>"
    }
  },
  "deployment": {
    "autoscalingSpecification": {
      "enabled": true,
      "maxReplicas": 15,
      "minReplicas": 15,
      "scaleDownStabilizationWindowSeconds": 1800,
      "scaleUpStabilizationWindowSeconds": 1800,
      "targetCpuAvgUtilizationPct": 50,
      "targetMemoryAvgUtilizationPct": 50,
      "useSessionAffinity": true
    },
    "hardwareTierId": "<string>",
    "vanityUrl": "<string>"
  },
  "description": "<string>",
  "versionNumber": 123
}

Authorizations

​
X-Domino-Api-Key
string
header
required

Path Parameters

​
appId
string
required

Body

application/json

Create a new version of an App. The content sub-object carries reproducibility fields (including the per-version mountDatasets override) and deployment carries execution settings. Top-level fields are version metadata that don't fit cleanly into the content/deployment groupings.

​
bundleId
string

Guardrails bundle ID.

​
content
object

Reproducibility fields that define the version's content. All fields are optional; omitted fields fall back to App-level defaults or the previous draft's values depending on context. Mirrors the response-side AppVersionContent shape.

​
deployment
object

Execution settings for the version. All fields are optional; omitted fields fall back to App-level defaults or the previous version's values depending on context. Mirrors the response-side AppVersionDeployment shape.

​
description
string

Optional version description.

​
tags
object[]
​
workspaceId
string

Draft only. ID of the apps-authoring workspace to associate with this draft version. Returns 422 if the parent App is not a draft.

Response

Success

​
createdAt
number<epoch>
required
​
id
string
required
​
tags
object[]
required
​
updatedAt
number<epoch>
required
​
bundle
object
​
content
object

Reproducibility fields that define the version's content.

​
currentInstance
object
​
deployment
object

Execution settings for the version.

​
description
string
​
versionNumber
integer<int64>

Monotonically increasing version number derived from creationOrder.