---
title: "Changes to Update artifact metadata"
method: PUT
path: "/groups/{groupId}/artifacts/{artifactId}"
---

# Changes to Update artifact metadata

`PUT /groups/{groupId}/artifacts/{artifactId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 126 revisions.

- **2026-10-31** `ff9684af2aad`: 20 info
- **2026-10-29** `f17f5df4e79c`: 4 info
- **2025-12-16** `440db8997574`: 2 info
- **2024-09-06** `948bffd5d083`: 4 warning, 8 info
- **2024-03-13** `b4b182eb7468`: 3 breaking, 8 warning, 9 info
- **2024-02-16** `8ec5f92da35d`: 1 breaking, 1 info
- **2024-02-07** `d761f09f101e`: 1 breaking, 1 warning
- **2024-01-25** `35e85f455b84`: 1 breaking, 3 info
- **2023-02-02** `5152639bee96`: 1 warning
- **2023-02-02** `e6eab48425c4`: 1 info
- **2023-02-02** `565fa69368e0`: 1 info
- **2023-02-02** `71202e0fe3eb`: 1 info
- **2022-11-24** `29b79a1c2c74`: 10 info
- **2022-04-25** `d1a3061ccc48`: 1 info
- **2022-04-01** `79156695de01`: 1 info
- **2022-03-21** `28ef359d858e`: 1 info

## Changes

- **2026-10-31** `ff9684af2aad`: 20 info
  - added the optional property `ruleViolation/causes/items/code` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `404` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `404` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `404` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `404` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `500` status
  - added the optional property `ruleViolation/ruleType` to the response with the `401` status
  - added the optional property `ruleViolation/ruleType` to the response with the `403` status
  - added the optional property `ruleViolation/ruleType` to the response with the `404` status
  - added the optional property `ruleViolation/ruleType` to the response with the `500` status
- **2026-10-29** `f17f5df4e79c`: 4 info
  - added the optional property `ruleViolation` to the response with the `401` status
  - added the optional property `ruleViolation` to the response with the `403` status
  - added the optional property `ruleViolation` to the response with the `404` status
  - added the optional property `ruleViolation` to the response with the `500` status
- **2025-12-16** `440db8997574`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
- **2024-09-06** `948bffd5d083`: 4 warning, 8 info
  - removed the optional property `error_code` from the response with the `404` status
  - removed the optional property `error_code` from the response with the `500` status
  - removed the optional property `message` from the response with the `404` status
  - removed the optional property `message` from the response with the `500` status
  - added the optional property `instance` to the response with the `404` status
  - added the optional property `instance` to the response with the `500` status
  - added the optional property `type` to the response with the `404` status
  - added the optional property `type` to the response with the `500` status
  - added the required property `status` to the response with the `404` status
  - added the required property `status` to the response with the `500` status
  - added the required property `title` to the response with the `404` status
  - added the required property `title` to the response with the `500` status
- **2024-03-13** `b4b182eb7468`: 3 breaking, 8 warning, 9 info
  - removed the media type `*/*` from the request body
  - removed the media type `application/vnd.create.extended+json` from the request body
  - removed the success response with the status `200`
  - deleted the `header` request parameter `X-Registry-Artifact-Branches`
  - deleted the `header` request parameter `X-Registry-Description`
  - deleted the `header` request parameter `X-Registry-Description-Encoded`
  - deleted the `header` request parameter `X-Registry-Name`
  - deleted the `header` request parameter `X-Registry-Name-Encoded`
  - deleted the `header` request parameter `X-Registry-Version`
  - removed the request property `content`
  - removed the request property `references`
  - api operation id `updateArtifact` removed and replaced with `updateArtifactMetaData`
  - api tag `Metadata` added
  - api tag `Artifacts` removed
  - added the new optional request property `description`
  - added the new optional request property `labels`
  - added the new optional request property `name`
  - added the new optional request property `owner`
  - removed the non-success response with the status `409`
  - added the success response with the status `204`
- **2024-02-16** `8ec5f92da35d`: 1 breaking, 1 info
  - removed the required property `createdBy` from the response with the `200` status
  - added the required property `owner` to the response with the `200` status
- **2024-02-07** `d761f09f101e`: 1 breaking, 1 warning
  - the `labels` response's property type changed from `array` to `object` for status `200`
  - removed the optional property `properties` from the response with the `200` status
- **2024-01-25** `35e85f455b84`: 1 breaking, 3 info
  - added the pattern `^[a-zA-Z0-9._\-+]{1,256}$` to the `header` request parameter `X-Registry-Version`
  - added the new optional `header` request parameter `X-Registry-Artifact-Branches`
  - the `groupId` response's property pattern `^.{1,512}$` was added for the status `200`
  - the `id` response's property pattern `^.{1,512}$` was added for the status `200`
- **2023-02-02** `5152639bee96`: 1 warning
  - deleted the `header` request parameter `Content-Type`
- **2023-02-02** `e6eab48425c4`: 1 info
  - the request's body type was generalized from no type to `string`, and format from no format to `binary`
- **2023-02-02** `565fa69368e0`: 1 info
  - added the media type `application/vnd.create.extended+json` to the request body
- **2023-02-02** `71202e0fe3eb`: 1 info
  - added the new optional `header` request parameter `Content-Type`
- **2022-11-24** `29b79a1c2c74`: 10 info
  - removed the `ASYNCAPI` enum value from the `type` response property for the response status `200`
  - removed the `AVRO` enum value from the `type` response property for the response status `200`
  - removed the `GRAPHQL` enum value from the `type` response property for the response status `200`
  - removed the `JSON` enum value from the `type` response property for the response status `200`
  - removed the `KCONNECT` enum value from the `type` response property for the response status `200`
  - removed the `OPENAPI` enum value from the `type` response property for the response status `200`
  - removed the `PROTOBUF` enum value from the `type` response property for the response status `200`
  - removed the `WSDL` enum value from the `type` response property for the response status `200`
  - removed the `XML` enum value from the `type` response property for the response status `200`
  - removed the `XSD` enum value from the `type` response property for the response status `200`
- **2022-04-25** `d1a3061ccc48`: 1 info
  - the request's body type was generalized from `string` to no type, and format from `binary` to no format
- **2022-04-01** `79156695de01`: 1 info
  - added the media type `application/create.extended+json` to the request body
- **2022-03-21** `28ef359d858e`: 1 info
  - added the optional property `references` to the response with the `200` status

---

[Operation](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/docs/groups/:groupId/artifacts/:artifactId/put.md) - [API](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3.md) - [Page](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/changes/groups/:groupId/artifacts/:artifactId/put)
