---
title: "Create a branch"
method: POST
path: "/v2/project/branches/create"
tags: ["Branches"]
---

# Create a branch

`POST /v2/project/branches/create`

Create a new branch, or rename and confirm the default branch.

## Headers

- `gt-api-version` '2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1'
- `gt-project-id` string

## Request body

- object
  - `branchName` string, required
  - `defaultBranch` boolean

## Response `200`

Created branch.

- object
  - `branch` Branch
    - `id` string
    - `name` string

## Other responses

- `400` — The request was invalid.
- `401` — Missing or invalid API key.
- `403` — Forbidden. Free plans cannot create non-default branches.

---

[API](https://skmtc.net/generaltranslation/apis/general-translation-api.md) · [All operations](https://skmtc.net/generaltranslation/apis/general-translation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/generaltranslation/general-translation-api/revisions/7e9372f17040/schema)