---
title: "Changes to Replace list of versions in branch"
method: PUT
path: "/groups/{groupId}/artifacts/{artifactId}/branches/{branchId}/versions"
---

# Changes to Replace list of versions in branch

`PUT /groups/{groupId}/artifacts/{artifactId}/branches/{branchId}/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 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-06-14** `18024dc32fcd`: 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-06-14** `18024dc32fcd`: 1 info
  - endpoint added

---

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