---
title: "Create a new branch"
method: POST
path: "/v1/projects/{project_id}/branches/{branch}"
tags: ["Branch API"]
---

# Create a new branch

`POST /v1/projects/{project_id}/branches/{branch}`

## Path parameters

- `project_id` string, uuid, required
- `branch` string, required

## Query parameters

- `source_branch` string, required

## Response `200`

OK, created

## Other responses

- `400` — Error codes:<br />&nbsp;<br />- `bad_request` when request generally is not well formed<br />- `limit_reached` when project already has max allowed number of branches<br />- `projects_limit_read_only` when project is in read-only state due to exceeded projects limit
- `404` — Not Found

## Changes

- **2026-08-17** `8473a4c4d4f9` — 4 warning
  - added the new `qa_checks_failed` enum value to the `errorCode` response property for the response status `400`
  - added the new `qa_checks_failed` enum value to the `errorCode` response property for the response status `404`
  - added the new `qa_checks_not_supported` enum value to the `errorCode` response property for the response status `400`
  - added the new `qa_checks_not_supported` enum value to the `errorCode` response property for the response status `404`

[Change history](https://skmtc.dev/localizely/apis/localizely-api/changes/v1/projects/:project_id/branches/:branch/post.md)

---

[API](https://skmtc.dev/localizely/apis/localizely-api.md) · [All operations](https://skmtc.dev/localizely/apis/localizely-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/localizely/localizely-api/revisions/8473a4c4d4f9/schema)