---
title: "Update Version of an Artefact."
method: PATCH
path: "/orgs/{orgId}/artefacts/{artefactId}/versions/{versionId}"
tags: ["public", "ArtefactVersion"]
---

# Update Version of an Artefact.

`PATCH /orgs/{orgId}/artefacts/{artefactId}/versions/{versionId}`

Update the version of a specified Artefact registered with your organization".

## Path parameters

- `orgId` string, required
- `artefactId` string, required
- `versionId` string, required

## Request body

- UpdateArtefactVersionPayloadRequest — UpdateArtefactVersionPayload contains the `archived` field that should be set in the Artefact Version to update.
  - `archived` boolean, nullable, required — The Value of the archived value.

## Response `200`

The updated Artefact Version.

- union — The details of an Artefact Version. The type field dictates the type of Artefact along with any additional fields.
  - object — Details of a Container Artefact Version
    - `type` string, required — The Artefact Version type.
    - `archived` boolean, required — If the Artefact Version is archived.
    - `artefact_id` string, required — The UUID of the Artefact.
    - `commit` string, required — (Optional) The commit ID the Artefact Version was built on.
    - `created_at` string — The time when the Artefact Version was added to Humanitec.
    - `created_by` string — The user ID of the user who added the Artefact Version to Humanitec.
    - `id` string, required — The UUID of the Artefact Version.
    - `name` string, required — The name of the Artefact.
    - `ref` string, required — (Optional) The ref the Artefact Version was built from.
    - `updated_at` string — The time when the Artefact Version was updated for the last time.
    - `updated_by` string — The user ID of the user who performed the last updated on the Artefact Version.
    - `version` string — (Optional) The version of the Artefact Version.
    - `digest` string, required — (Optional) The Artefact Version digest.
  - object — Details of a Workload Artefact Version
    - `type` string, required — The Artefact Version type.
    - `archived` boolean, required — If the Artefact Version is archived.
    - `artefact_id` string, required — The UUID of the Artefact.
    - `commit` string — (Optional) The commit ID the Artefact Version was built on.
    - `created_at` string — The time when the Artefact Version was added to Humanitec.
    - `created_by` string — The user ID of the user who added the Artefact Version to Humanitec.
    - `id` string, required — The UUID of the Artefact Version.
    - `name` string, required — The name of the Artefact.
    - `ref` string — (Optional) The ref the Artefact Version was built from.
    - `updated_at` string — The time when the Artefact Version was updated for the last time.
    - `updated_by` string — The user ID of the user who performed the last updated on the Artefact Version.
    - `version` string — (Optional) The version of the Artefact Version.

## Other responses

- `400` — One or more request parameters are missing or invalid, or the requested payload is not provided or malformed.
- `401` — Request unauthorised.
- `403` — Update requested on a version of a builtin artefact.
- `404` — No Artefact with the supplied artefactId or no Artefact Version with the supplied versionId have been found within the organization.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)