---
title: "Updates a DAIEngineVersion."
method: PATCH
path: "/v1/{daiEngineVersion.name}"
tags: ["DAIEngineVersionService"]
---

# Updates a DAIEngineVersion.

`PATCH /v1/{daiEngineVersion.name}`

## Request

- Base URL: `https://docs.h2o.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.h2o.ai/v1/{daiEngineVersion.name}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/docs/v1/:daiEngineVersion.name/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `daiEngineVersion.name` string, required

## Query parameters

- `updateMask` string, required

## Request body

- object: Authorization may require the following permission on the daiEngineVersion's parent workspace: * actions/enginemanager/daiEngineVersions/UPDATE
  - `deprecated` boolean: Indicates whether DAIEngineVersion is deprecated.
  - `aliases` string[]: Optional. ResourceID aliases for this DAIEngineVersion. Aliases are unique within the workspace (two versions in the same workspace cannot have the same alias). Any alias must be in format: - contain 1-63 characters - contain only lowercase alphanumeric characters or hyphen ('-') - start with an alphabetic character - end with an alphanumeric character This matches a regular expression: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$ For example: when DAIEngineVersion with name "workspaces/global/daiEngineVersions/1.11.1" has aliases={"latest", "prerelease"}, then "workspaces/global/daiEngineVersions/latest" will refer to this DAIEngineVersion.
  - `image` string, required: Name of the Docker image used when using this DAIEngineVersion.
  - `imagePullPolicy` 'IMAGE_PULL_POLICY_UNSPECIFIED' | 'IMAGE_PULL_POLICY_ALWAYS' | 'IMAGE_PULL_POLICY_NEVER' | 'IMAGE_PULL_POLICY_IF_NOT_PRESENT': Policy for downloading an image in K8s. - IMAGE_PULL_POLICY_UNSPECIFIED: Unspecified image pull policy. - IMAGE_PULL_POLICY_ALWAYS: Every time the container is launched, the container image registry is queried to resolve the name to an image digest. - IMAGE_PULL_POLICY_NEVER: Do not try to fetch the image. If the image is already present locally, the container will start. If the image is not present, container startup will fail. - IMAGE_PULL_POLICY_IF_NOT_PRESENT: The image is pulled only if it is not already present locally.
  - `imagePullSecrets` string[]: List of references to k8s secrets that can be used for pulling an image of this DAIEngineVersion from a private container image registry or repository.
  - `createTime` string, date-time: Output only. Time when the DAIEngineVersion was created.
  - `updateTime` string, date-time, nullable: Output only. Time when the DAIEngineVersion was last updated.
  - `creator` string: Output only. Name of entity that created the DAIEngineVersion.
  - `updater` string: Output only. Name of entity that last updated the DAIEngineVersion.
  - `creatorDisplayName` string: Output only. Human-readable name of entity that created the DAIEngineVersion.
  - `updaterDisplayName` string: Output only. Human-readable name of entity that last updated the DAIEngineVersion.

## Response `200`

A successful response.

- V1UpdateDAIEngineVersionResponse: Response for Update method.
  - `daiEngineVersion` V1DAIEngineVersion: DAIEngineVersion represents Driverless AI version that can be used in DAIEngine.
    - `name` string
    - `deprecated` boolean: Indicates whether DAIEngineVersion is deprecated.
    - `aliases` string[]: Optional. ResourceID aliases for this DAIEngineVersion. Aliases are unique within the workspace (two versions in the same workspace cannot have the same alias). Any alias must be in format: - contain 1-63 characters - contain only lowercase alphanumeric characters or hyphen ('-') - start with an alphabetic character - end with an alphanumeric character This matches a regular expression: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$ For example: when DAIEngineVersion with name "workspaces/global/daiEngineVersions/1.11.1" has aliases={"latest", "prerelease"}, then "workspaces/global/daiEngineVersions/latest" will refer to this DAIEngineVersion.
    - `image` string, required: Name of the Docker image used when using this DAIEngineVersion.
    - `imagePullPolicy` 'IMAGE_PULL_POLICY_UNSPECIFIED' | 'IMAGE_PULL_POLICY_ALWAYS' | 'IMAGE_PULL_POLICY_NEVER' | 'IMAGE_PULL_POLICY_IF_NOT_PRESENT': Policy for downloading an image in K8s. - IMAGE_PULL_POLICY_UNSPECIFIED: Unspecified image pull policy. - IMAGE_PULL_POLICY_ALWAYS: Every time the container is launched, the container image registry is queried to resolve the name to an image digest. - IMAGE_PULL_POLICY_NEVER: Do not try to fetch the image. If the image is already present locally, the container will start. If the image is not present, container startup will fail. - IMAGE_PULL_POLICY_IF_NOT_PRESENT: The image is pulled only if it is not already present locally.
    - `imagePullSecrets` string[]: List of references to k8s secrets that can be used for pulling an image of this DAIEngineVersion from a private container image registry or repository.
    - `createTime` string, date-time: Output only. Time when the DAIEngineVersion was created.
    - `updateTime` string, date-time, nullable: Output only. Time when the DAIEngineVersion was last updated.
    - `creator` string: Output only. Name of entity that created the DAIEngineVersion.
    - `updater` string: Output only. Name of entity that last updated the DAIEngineVersion.
    - `creatorDisplayName` string: Output only. Human-readable name of entity that created the DAIEngineVersion.
    - `updaterDisplayName` string: Output only. Human-readable name of entity that last updated the DAIEngineVersion.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto.md) - [All operations](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/ai-h2o-engine-sandbox-v1-filesystem-proto/revisions/297cfadc1d39?raw)