---
title: "Changes to Update a branch"
method: PUT
path: "/branches/{branch_id}"
---

# Changes to Update a branch

`PUT /branches/{branch_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2026-07-17** `1f2ae877f985`: 2 info
- **2023-04-02** `663cd77f4c7a`: 2 info
- **2023-02-18** `7796ef19a4c9`: 2 info
- **2021-07-09** `6f4f98f500b0`: 1 breaking, 3 info
- **2021-01-31** `ecd12e02213d`: 2 info
- **2021-01-31** `6dffc3a4de00`: 2 breaking

## Changes

- **2026-07-17** `1f2ae877f985`: 2 info
  - added the new optional request property `env_vars`
  - added the optional property `env_vars` to the response with the `200` status
- **2023-04-02** `663cd77f4c7a`: 2 info
  - added the new optional request property `created`
  - added the optional property `created` to the response with the `200` status
- **2023-02-18** `7796ef19a4c9`: 2 info
  - added the new optional request property `retention_policy`
  - added the optional property `retention_policy` to the response with the `200` status
- **2021-07-09** `6f4f98f500b0`: 1 breaking, 3 info
  - the response property `name` became optional for the status `200`
  - added the new optional request property `forking_model`
  - the request property `name` became optional
  - added the optional property `forking_model` to the response with the `200` status
- **2021-01-31** `ecd12e02213d`: 2 info
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
- **2021-01-31** `6dffc3a4de00`: 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

---

[Operation](https://skmtc.dev/kraken-ci/apis/server-api/docs/branches/:branch_id/put.md) - [API](https://skmtc.dev/kraken-ci/apis/server-api.md) - [Page](https://skmtc.dev/kraken-ci/apis/server-api/changes/branches/:branch_id/put)