---
title: "Changes to Delete branch."
method: DELETE
path: "/groups/{groupId}/artifacts/{artifactId}/branches/{branchId}"
---

# Changes to Delete branch.

`DELETE /groups/{groupId}/artifacts/{artifactId}/branches/{branchId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 126 revisions.

- **2026-10-31** `ff9684af2aad`: 25 info
- **2026-10-29** `f17f5df4e79c`: 5 info
- **2025-12-16** `440db8997574`: 2 info
- **2024-09-06** `948bffd5d083`: 6 warning, 12 info
- **2024-06-14** `18024dc32fcd`: 1 info
- **2024-01-25** `fbd75432faa3`: 1 info

## Changes

- **2026-10-31** `ff9684af2aad`: 25 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 `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 `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 `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 `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 `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`: 5 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 `409` 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`: 6 warning, 12 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 `409` 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 `409` 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 `409` 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 `409` 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 `409` 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 `409` status
  - added the required property `title` to the response with the `500` status
- **2024-06-14** `18024dc32fcd`: 1 info
  - api operation id `deleteArtifactBranch` removed and replaced with `deleteBranch`
- **2024-01-25** `fbd75432faa3`: 1 info
  - endpoint added

---

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