---
title: "Create a branch"
method: POST
path: "/v0/projects/{project}/branches"
tags: ["projects", "branches"]
---

# Create a branch

`POST /v0/projects/{project}/branches`

Create a branch for a project. The user must have `create` permissions for the project, or provide a valid project key for the project.

## Path parameters

- `project` string, required

## Request body

- JsonNewBranch
  - `name` string, required
  - `slug` string
  - `start_point` JsonNewStartPoint
    - `branch` string, required
    - `clone_thresholds` boolean, nullable — If set to `true`, the thresholds from the start point branch will be deep copied to the new branch. This can be useful for pull request branches that should have the same thresholds as their target branch. Requires the `branch` field to be set.
    - `hash` string
    - `max_versions` integer, nullable — The maximum number of historical branch versions to include. Versions beyond this number will be omitted. The default is 255. Requires the `branch` field to be set.

## Response `201`

successful creation

- JsonBranch
  - `archived` string, date-time
  - `created` string, date-time, required
  - `head` JsonHead, required
    - `created` string, date-time, required
    - `replaced` string, date-time
    - `start_point` JsonStartPoint
      - `branch` string, uuid, required
      - `head` string, uuid, required
      - `version` JsonVersion, required
        - `hash` string
        - `number` integer, required
    - `uuid` string, uuid, required
    - `version` JsonVersion
      - `hash` string
      - `number` integer, required
  - `modified` string, date-time, required
  - `name` string, required
  - `project` string, uuid, required
  - `slug` string, required
  - `uuid` string, uuid, required

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/bencherdev/apis/bencher-api.md) · [All operations](https://skmtc.net/bencherdev/apis/bencher-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bencherdev/bencher-api/versions/84086e99e6cd/schema)