---
title: "Branch update"
method: PUT
path: "/v2/storage/dev-branches/{id}"
tags: ["Development Branches"]
---

# Branch update

`PUT /v2/storage/dev-branches/{id}`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/dev-branches/{id}`
- Auth: one of:
  - API key in header `X-StorageApi-Token`
  - API key in header `X-KBC-ManageApiToken`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/dev-branches/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates name and/or description of a development branch. Update of a default branch name is not allowed.

## Path parameters

- `id` integer, required

## Request body

- UpdateDevBranchRequest: At least one of name or description must be provided.
  - `name` string: New name of the branch. Must not be blank; the default branch cannot be renamed.
  - `description` string: New description of the branch.

## Response `200`

Updated branch detail.

- DevBranchResponse: Development branch detail.
  - `id` integer, required: Branch ID.
  - `name` string, required: Branch name.
  - `description` string, required: Branch description.
  - `created` string, required: Creation time, ISO 8601 with a `+hhmm` offset.
  - `isDefault` boolean, required: True for the default (production) branch.
  - `creatorToken` union, required: Token that created the branch; `[]` for a branch with no creator token, such as the default branch.
    - object
      - `id` integer, required: Creator token ID; 0 when the creator is not backed by a token.
      - `name` string, required: Creator token description.
    - unknown[]
      - unknown
  - `actor` ActorResponse, required: Who performed the action and through which credential.
    - `type` 'token' | 'session' | 'pat' | 'system', required: Credential the action came through: a Storage token, a programmatic session, a personal access token, or system work.
    - `id` string, required: Token id as a string, session or personal access token UUID, or the system subject.
    - `name` string, required: Token description, the admin email for a session or personal access token, or the system label, as it was when the action happened.
    - `adminId` integer, nullable, required: Admin behind the credential; null for a token without an admin, for system work, and when the admin was not recorded (an object whose creator is known only from its token columns, including rows backfilled from them).

## Other responses

- `400`: Returned when the request is invalid or the default branch name is being updated (`devBranch.defaultBranchNameCannotBeUpdated`).
- `403`: Returned when the token is not allowed to manipulate development branches.
- `404`: Returned when the branch does not exist in the project.

---

[API](https://skmtc.dev/keboola/apis/keboola-storage-api.md) - [All operations](https://skmtc.dev/keboola/apis/keboola-storage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keboola/apis/keboola-storage-api/revisions/34b5ceac0317?raw)