Skip to main content
PATCH
Update App Version (v1)

Authorizations

X-Domino-Api-Key
string
header
required

Path Parameters

appId
string
required
versionId
string
required

Body

application/json

Update a version. Only metadata fields (description, tags, bundleId) are accepted. Content and deployment fields return 422. workspaceId is accepted only when the parent App is a draft; if provided, associates the draft App with the given workspace. If the workspace is already linked to a different draft, that draft is deleted before the new link is established. Returns 422 if workspaceId is provided and the parent App is not a draft.

bundleId
string

Guardrails bundle ID. Can only be set once per version. If the version already has a bundleId, the request fails. If the provided bundleId does not exist, the request fails.

description
string
tags
object[]
workspaceId
string

Draft only. ID of the apps-authoring workspace to associate with this draft version. If the workspace is already linked to a different draft, that draft is deleted first. 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.