---
title: "Changes to Update the artifact version state"
method: PUT
path: "/groups/{groupId}/artifacts/{artifactId}/versions/{versionExpression}/state"
---

# Changes to Update the artifact version state

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 126 revisions.

- **2026-10-31** `ff9684af2aad`: 30 info
- **2026-10-29** `f17f5df4e79c`: 6 info
- **2026-05-18** `561c6d6c6989`: 1 info
- **2025-12-16** `440db8997574`: 2 info
- **2024-10-15** `95e926f2874a`: 1 info
- **2024-03-13** `b4b182eb7468`: 1 breaking

## Changes

- **2026-10-31** `ff9684af2aad`: 30 info
  - added the optional property `ruleViolation/causes/items/code` to the response with the `400` status
  - 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 `409` 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 `400` 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 `409` 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 `400` 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 `409` 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 `400` 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 `409` 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 `400` 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 `409` status
  - added the optional property `ruleViolation/ruleType` to the response with the `500` status
- **2026-10-29** `f17f5df4e79c`: 6 info
  - added the optional property `ruleViolation` to the response with the `400` status
  - 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 `409` status
  - added the optional property `ruleViolation` to the response with the `500` status
- **2026-05-18** `561c6d6c6989`: 1 info
  - added the new `SUNSET` enum value to the request property `state`
- **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-10-15** `95e926f2874a`: 1 info
  - endpoint added
- **2024-03-13** `b4b182eb7468`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/docs/groups/:groupId/artifacts/:artifactId/versions/:versionExpression/state/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/versions/:versionExpression/state/put)