Skip to main content
POST
Create App Version (v1)

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

The most recently created instance for this AppVersion.

deployment
object

Execution settings for the version.

description
string
versionNumber
integer<int64>

Monotonically increasing version number derived from creationOrder.