---
title: "Changes to Update a branch"
method: PATCH
path: "/v0/projects/{project}/branches/{branch}"
---

# Changes to Update a branch

`PATCH /v0/projects/{project}/branches/{branch}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 194 revisions.

- **2026-10-22** `fa0ddcf7e9f7`: 1 info
- **2025-08-10** `c2d6b1d67c04`: 2 info
- **2025-08-10** `e1332be6f87b`: 1 breaking, 1 warning
- **2025-08-09** `857f697f66a4`: 1 breaking, 1 warning
- **2025-08-09** `2be9839636fa`: 1 breaking, 1 warning
- **2025-08-09** `ca83201e45e6`: 2 breaking, 1 warning
- **2025-08-08** `7b38ab3b0881`: 1 breaking, 1 warning

## Changes

- **2026-10-22** `fa0ddcf7e9f7`: 1 info
  - added the new optional request property `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/idempotency_key`
- **2025-08-10** `c2d6b1d67c04`: 2 info
  - for the `path` request parameter `branch`, the type was generalized from `string` to no type
  - for the `path` request parameter `project`, the type was generalized from `string` to no type
- **2025-08-10** `e1332be6f87b`: 1 breaking, 1 warning
  - added `#/components/schemas/NameId` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NameId_for_BranchUuid_and_BranchSlug_and_BranchName` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
- **2025-08-09** `857f697f66a4`: 1 breaking, 1 warning
  - added `#/components/schemas/NameId_for_BranchUuid_and_BranchSlug_and_BranchName` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NamedId_for_BranchUuid_and_BranchSlug_and_BranchName` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
- **2025-08-09** `2be9839636fa`: 1 breaking, 1 warning
  - added `#/components/schemas/NamedId_for_BranchUuid_and_BranchSlug_and_BranchName` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NameId_for_BranchName` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
- **2025-08-09** `ca83201e45e6`: 2 breaking, 1 warning
  - added `#/components/schemas/BranchSlug` to the `slug` request property `allOf` list
  - the `slug` response's property type changed from `string` to no type for status `200`
  - removed `#/components/schemas/Slug` from the `slug` request property `allOf` list
- **2025-08-08** `7b38ab3b0881`: 1 breaking, 1 warning
  - added `#/components/schemas/NameId_for_BranchName` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NameId` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list

---

[Operation](https://skmtc.dev/bencherdev/apis/bencher-api/docs/v0/projects/:project/branches/:branch/patch.md) - [API](https://skmtc.dev/bencherdev/apis/bencher-api.md) - [Page](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/projects/:project/branches/:branch/patch)