---
title: "Update artifact version content"
method: PUT
path: "/groups/{groupId}/artifacts/{artifactId}/versions/{versionExpression}/content"
tags: ["Versions"]
---

# Update artifact version content

`PUT /groups/{groupId}/artifacts/{artifactId}/versions/{versionExpression}/content`

Updates the content of a single version of an artifact.

NOTE: the artifact must be in `DRAFT` status.

Both the `artifactId` and the unique `version` number must be provided to identify
the version to update.

This operation can fail for the following reasons:

* No artifact with this `artifactId` exists (HTTP error `404`)
* No version with this `version` exists (HTTP error `404`)
* Artifact version not in `DRAFT` status (HTTP error `409`)
* A server error occurred (HTTP error `500`)

## Request body

- VersionContent
  - `content` string, required — Raw content of the artifact version or a valid (and accessible) URL where the content can be found.
  - `references` ArtifactReference[] — Collection of references to other artifacts.
    - `groupId` string, required
    - `artifactId` string, required
    - `version` string
    - `name` string, required
  - `contentType` string, required — The content-type, such as `application/json` or `text/xml`.
  - `encoding` 'base64' — Optional encoding for the content property. When set to 'base64', the content value will be base64-decoded by the server before processing.

## Response `204`

The artifact version content was successfully updated.

## Other responses

- `401` — Common response for all operations that can return a `401` error indicating authentication is required.
- `403` — Common response for all operations that can return a `403` error indicating the user is authenticated but not authorized.
- `404` — Common response for all operations that can return a `404` error.
- `405` — Common response for all operations that can fail due to method not allowed or disabled.
- `409` — Common response used when an input conflicts with existing data.
- `500` — Common response for all operations that can fail with an unexpected server error.

---

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